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

Menetapkan Tugas Info Hotel Google

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 Info Hotel Google

​

Memasukkan carian penyenaraian hotel ke baris gilir, memulangkan id tugas. Dibungkus dalam sampul DataForSEO: data dalam tasks[0].result, hasil dalam tasks[0].status_code - permintaan yang ditolak masih memulangkan HTTP 200. Dapatkan versi terhuraikan dengan get_dataforseo_business_google_hotel_info_fetch atau versi mentah dengan get_dataforseo_business_google_hotel_info_fetch_html.

Rujukan harga

  • Pemeteran: kos respons yang dilaporkan.
  • Anggaran rujukan setiap permintaan: USD 0,2428.
  • Pengganda rujukan pelanggan: 1,0. Jangan gunakannya 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)[]
    • adults
      Jenis: integer | null

      bilangan orang dewasa
      medan pilihan
      jika anda tidak menentukan medan ini, dua orang dewasa akan digunakan secara lalai
      contoh:
      1

    • check_in
      Jenis: string | null

      tarikh daftar masuk
      medan pilihan
      jika anda tidak menentukan medan ini, tarikh esok akan digunakan secara lalai;
      nilai tidak boleh lebih awal daripada tarikh hari ini
      format tarikh: "yyyy-mm-dd"
      contoh:
      "2019-01-15"

    • check_out
      Jenis: string | null

      tarikh daftar keluar
      medan pilihan
      jika anda tidak menentukan medan ini, sistem kami akan menggunakan tarikh dua hari dari sekarang secara lalai;
      Nota: nilai tidak boleh kurang daripada atau sama dengan check_in;
      julat antara nilai check_in dan check_out tidak boleh melebihi 30 hari
      format tarikh: "yyyy-mm-dd"
      contoh:
      "2019-01-15"

    • children
      Jenis: array string[] | null

      bilangan dan umur kanak-kanak
      medan pilihan
      jika anda tidak menentukan medan ini, tiada kanak-kanak akan disertakan dalam carian;

      tetapkan nilai berikut jika anda ingin menyertakan seorang kanak-kanak berumur 14 tahun:
      [14]
      tetapkan nilai berikut jika anda ingin menyertakan seorang kanak-kanak berumur 13 tahun dan seorang kanak-kanak berumur 8 tahun:
      [13,8]

    • currency
      Jenis: string | null

      mata wang
      medan pilihan
      contoh:
      "USD"

    • hotel_identifier
      Jenis: string

      pengecam hotel unik
      medan wajib jika anda tidak menentukan keyword
      jika anda menggunakan medan ini, anda tidak perlu menentukan keyword
      pengecam unik entiti hotel dalam carian Google;
      anda boleh mendapatkan nilai ini dengan membuat permintaan ke Advanced Google SERP API (termasuk dalam elemen hotels_pack respons), atau endpoint Hotel Searches bagi Business Data API
      contoh:
      ChYIq6SB--i6p6cpGgovbS8wN2s5ODZfEAE

    • keyword
      Jenis: string

      kata kunci
      medan wajib jika anda tidak menentukan hotel_identifier
      jika anda menggunakan medan ini, anda tidak perlu menentukan hotel_identifier
      kata kunci yang anda tentukan hendaklah menunjukkan nama entiti hotel
      anda boleh menentukan sehingga 700 aksara dalam medan keyword
      semua %## akan dinyahkod (aksara ‘+’ juga akan dinyahkod menjadi aksara ruang)
      jika anda perlu menggunakan aksara “%” untuk keyword, nyatakan sebagai “%25”

    • 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 bersama language_code masing-masing dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/business_data/google/languages
      contoh:
      en

    • 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 language_name dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/business_data/google/languages
      contoh:
      English

    • load_prices_by_dates
      Jenis: boolean | null

      muatkan harga penginapan hotel mengikut tarikh
      medan pilihan
      jika anda menentukan parameter ini dengan true, respons akan menyertakan array prices_by_dates dengan harga penginapan hotel yang dibahagikan mengikut tarikh
      jika anda menggunakan parameter ini, anda akan dicaj dua kali harga asas bagi setiap permintaan

    • 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 enjin carian yang tersedia bersama location_code dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/business_data/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"
      bilangan maksimum digit perpuluhan untuk "latitude" dan "longitude": 7
      Nota: jika koordinat digunakan untuk menetapkan lokasi, carian akan berlaku di penempatan terdekat;
      contoh:
      53.476225,-2.243572

    • 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 location_name dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/business_data/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 string ‘$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

      jenis data postback_url
      medan wajib jika anda menentukan postback_url
      sepadan dengan jenis data yang akan dihantar ke pelayan anda
      nilai yang mungkin:
      advanced, html

    • postback_url
      Jenis: string | null

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

    • prices_date_range
      Jenis: string | null

      tempoh pratetap untuk mendapatkan data harga harian
      medan pilihan
      untuk menggunakan parameter ini, anda mesti menentukan load_prices_by_dates dengan true
      jika prices_start_date tidak ditentukan, tarikh mula ditetapkan kepada tarikh check_in
      nilai yang mungkin: month, three_months, six_months, year
      nilai lalai: month

    • prices_end_date
      Jenis: string | null

      tarikh tamat untuk memuatkan harga mengikut tarikh
      medan pilihan
      untuk menggunakan parameter ini, anda mesti menentukan load_prices_by_dates dengan true
      jika parameter ini tidak ditentukan, anda akan mendapat harga mengikut tarikh untuk bulan tersebut
      format tarikh: yyyy-mm-dd
      contoh:
      2025-05-21

    • prices_start_date
      Jenis: string | null

      tarikh mula untuk memuatkan harga mengikut tarikh
      medan pilihan
      untuk menggunakan parameter ini, anda mesti menentukan load_prices_by_dates dengan true
      jika parameter ini tidak ditentukan, tarikh mula ditetapkan kepada tarikh check_in
      format tarikh: yyyy-mm-dd
      contoh:
      2025-05-20

    • 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.

    • 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_BusinessDataGoogleHotelInfoTaskPostResponseInfo
    • 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_BusinessDataGoogleHotelInfoTaskPostTaskInfo
        • 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/business_data/google/hotel_info/task_post
curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/hotel_info/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_name": "New York,New York,United States",
    "hotel_identifier": "ChYIq6SB--i6p6cpGgovbS8wN2s5ODZfEAE",
    "tag": "some_string_123",
    "postback_url": "https://your-server.com/postbackscript.php",
    "postback_data": "advanced"
  }
]'

{
  "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 Hotel Info Tasks