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

Menetapkan Tugas Soalan dan Jawapan Google My Business Langsung

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 Soalan dan Jawapan Google My Business Langsung

​

Soalan dan jawapan pada sesuatu Profil Perniagaan Google, ditemui mengikut keyword dan location_code. Memulangkan keyword, se_domain, location_code, language_code, check_url, datetime, cid, feature_id dan item_types. Dibungkus dalam sampul DataForSEO: data dalam tasks[0].result, hasil dalam tasks[0].status_code - permintaan yang ditolak masih memulangkan HTTP 200.

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)[]
    • depth
      Jenis: integer | null

      kedalaman penghuraian
      medan pilihan
      bilangan hasil dalam SERP
      nilai lalai: 20
      nilai maksimum: 100
      Akaun anda akan dicaj bagi setiap SERP yang mengandungi sehingga 20 hasil;
      Menetapkan kedalaman melebihi 20 boleh menyebabkan caj tambahan jika enjin carian memulangkan lebih daripada 20 hasil;
      Jika kedalaman yang ditentukan lebih tinggi daripada bilangan soalan dalam respons, perbezaannya akan dipulangkan secara automatik ke baki akaun anda;
      Kos boleh dikira di halaman Harga.

    • keyword
      Jenis: string

      kata kunci
      medan wajib
      kata kunci yang anda tentukan hendaklah menunjukkan nama pertubuhan tempatan
      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”;

      medan ini juga boleh digunakan untuk menghantar parameter berikut:
      cid - id unik entiti perniagaan yang ditentukan Google;
      place_id - pengecam entiti perniagaan dalam Google Maps;

      contoh:
      cid:194604053573767737
      place_id:GhIJQWDl0CIeQUARxks3icF8U8A

      ketahui lebih lanjut tentang pengecam cid dan place_id dalam artikel Pusat Bantuan ini

      ketahui lebih lanjut tentang peraturan dan had medan keyword dan keywords dalam API DataForSEO dalam artikel Pusat Bantuan ini

    • 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

    • location_code
      Jenis: integer

      kod lokasi enjin carian
      medan wajib jika anda tidak menetapkan location_name atau location_coordinate
      jika anda menggunakan medan ini, anda tidak perlu menetapkan location_name atau location_coordinate
      anda boleh mendapatkan senarai lokasi yang tersedia berserta 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,radius"
      bilangan maksimum digit perpuluhan untuk "latitude" dan "longitude": 7
      nilai minimum untuk "radius": 199.9 (mm)
      nilai maksimum untuk "radius": 199999 (mm)
      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 location_name dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/business_data/google/locations
      contoh:
      London,England,United Kingdom

    • 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_BusinessDataGoogleQuestionsAndAnswersLiveResponseInfo
    • 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_BusinessDataGoogleQuestionsAndAnswersLiveTaskInfo
        • 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: array (object | null)[] | null

          tatasusunan hasil

          • check_url
            Jenis: string | null

            URL terus ke hasil enjin carian
            anda boleh menggunakannya untuk memastikan bahawa kami memberikan hasil yang tepat

          • cid
            Jenis: string | null

            client id yang ditentukan Google
            id unik sesuatu pertubuhan tempatan;
            pelajari lebih lanjut tentang pengecam dalam artikel pusat bantuan ini

          • datetime
            Jenis: string | null

            tarikh dan masa hasil diterima
            dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
            contoh:
            2019-11-15 12:57:46 +00:00

          • feature_id
            Jenis: string | null

            pengecam unik ciri SERP

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

            jenis item
            jenis hasil enjin carian yang ditemui dalam array items;
            jenis item tersedia: google_business_question_item

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

            array item
            item dalam google_business_question_item

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

              array item
              item dalam google_business_question_item

              • answer_id
                Jenis: string | null

                ID jawapan

              • answer_text
                Jenis: string | null

                teks semasa jawapan

              • original_answer_text
                Jenis: string | null

                teks asal jawapan

              • profile_image_url
                Jenis: string | null

                URL imej profil pengguna

              • profile_name
                Jenis: string | null

                nama paparan pengguna

              • profile_url
                Jenis: string | null

                URL profil pengguna

              • time_ago
                Jenis: string | null

                anggaran masa jawapan disiarkan

              • timestamp
                Jenis: string | null

                masa tepat jawapan disiarkan

              • type
                Jenis: string | null

                jenis elemen

            • original_question_text
              Jenis: string | null

              teks asal soalan

            • profile_image_url
              Jenis: string | null

              URL imej profil pengguna

            • profile_name
              Jenis: string | null

              nama paparan pengguna

            • profile_url
              Jenis: string | null

              URL profil pengguna

            • question_id
              Jenis: string | null

              ID soalan

            • question_text
              Jenis: string | null

              teks semasa soalan

            • rank_absolute
              Jenis: integer | null

              kedudukan mutlak antara semua elemen

            • rank_group
              Jenis: integer | null

              kedudukan dalam kumpulan elemen dengan nilai type yang sama
              kedudukan elemen dengan nilai type berbeza dikecualikan daripada rank_group

            • time_ago
              Jenis: string | null

              anggaran masa soalan disiarkan

            • timestamp
              Jenis: string | null

              masa tepat soalan disiarkan

            • type
              Jenis: string | null

              jenis elemen

            • url
              Jenis: string | null

              URL soalan

          • items_count
            Jenis: integer | null Format: int64

            bilangan item dalam array items

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

            array item soalan perniagaan Google tanpa jawapan

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

              array item
              item dalam google_business_question_item

              • answer_id
                Jenis: string | null

                ID jawapan

              • answer_text
                Jenis: string | null

                teks semasa jawapan

              • original_answer_text
                Jenis: string | null

                teks asal jawapan

              • profile_image_url
                Jenis: string | null

                URL imej profil pengguna

              • profile_name
                Jenis: string | null

                nama paparan pengguna

              • profile_url
                Jenis: string | null

                URL profil pengguna

              • time_ago
                Jenis: string | null

                anggaran masa jawapan disiarkan

              • timestamp
                Jenis: string | null

                masa tepat jawapan disiarkan

              • type
                Jenis: string | null

                jenis elemen

            • original_question_text
              Jenis: string | null

              teks asal soalan

            • profile_image_url
              Jenis: string | null

              URL imej profil pengguna

            • profile_name
              Jenis: string | null

              nama paparan pengguna

            • profile_url
              Jenis: string | null

              URL profil pengguna

            • question_id
              Jenis: string | null

              ID soalan

            • question_text
              Jenis: string | null

              teks semasa soalan

            • rank_absolute
              Jenis: integer | null

              kedudukan mutlak antara semua elemen

            • rank_group
              Jenis: integer | null

              kedudukan dalam kumpulan elemen dengan nilai type yang sama
              kedudukan elemen dengan nilai type berbeza dikecualikan daripada rank_group

            • time_ago
              Jenis: string | null

              anggaran masa soalan disiarkan

            • timestamp
              Jenis: string | null

              masa tepat soalan disiarkan

            • type
              Jenis: string | null

              jenis elemen

            • url
              Jenis: string | null

              URL soalan

          • keyword
            Jenis: string | null

            kata kunci yang diterima dalam array POST
            kata kunci dipulangkan dengan %## dinyahkod (aksara tambah '+' akan dinyahkod menjadi aksara ruang)
            medan ini akan mengandungi parameter cid jika anda menetapkannya dalam medan keyword semasa menetapkan tugas;
            contoh:
            cid:2946633002421908862
            pelajari lebih lanjut tentang parameter dalam artikel pusat bantuan ini

          • language_code
            Jenis: string | null

            kod bahasa dalam array POST

          • location_code
            Jenis: integer | null

            kod lokasi dalam array POST

          • se_domain
            Jenis: string | null

            domain enjin carian seperti yang ditentukan dalam array POST

        • 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/questions_and_answers/live
curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/questions_and_answers/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_name": "Los Angeles,California,United States",
    "keyword": "The Last Bookstore"
  }
]'

{
  "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": [
        {
          "keyword": null,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "check_url": null,
          "datetime": null,
          "cid": null,
          "feature_id": null,
          "item_types": [
            null
          ],
          "items_without_answers": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "question_id": null,
              "url": null,
              "profile_image_url": null,
              "profile_url": null,
              "profile_name": null,
              "question_text": null,
              "original_question_text": null,
              "time_ago": null,
              "timestamp": null,
              "items": [
                "[Max Depth Exceeded]"
              ]
            }
          ],
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "question_id": null,
              "url": null,
              "profile_image_url": null,
              "profile_url": null,
              "profile_name": null,
              "question_text": null,
              "original_question_text": null,
              "time_ago": null,
              "timestamp": null,
              "items": [
                "[Max Depth Exceeded]"
              ]
            }
          ]
        }
      ]
    }
  ]
}

Operasi berjaya

Setting Live Google My Business Questions and Answers Tasks