Felo API PlatformFelo API Platform
Všechny endpointy DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Vytváření úloh otázek a odpovědí Google My Business naživo

Felo API Support
MIT
Server:https://openapi.felo.ai
Klientské knihovny
Shell Curl

DataForSEO

​

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Operace

Vytváření úloh otázek a odpovědí Google My Business naživo

​

Otázky a odpovědi v profilu Google Business Profile, nalezené podle keyword a location_code. Vrací keyword, se_domain, location_code, language_code, check_url, datetime, cid, feature_id a item_types. Odpověď je zabalena do obálky DataForSEO: data v tasks[0].result, výsledek v tasks[0].status_code – odmítnutý požadavek stále vrací HTTP 200.

Referenční ceny

  • Účtování: vykázaná cena odpovědi.
  • Referenční odhad ceny požadavku: USD 0.2428.
  • Referenční multiplikátor zákazníka: 1.0. Znovu jej neaplikujte na již zúčtovanou částku zákazníka.

Pouze referenční metadata — nikoli nabídka pro účet, garantovaná cena ani limit utrácení. Kredity prostředků nejsou kredity Felo. Konečné účtování se řídí fakturačními záznamy Felo.

Tělo
application/json
  • Typ: array (object | null)[]
    • depth
      Typ: integer | null

      hloubka parsování
      volitelné pole
      počet výsledků v SERP
      výchozí hodnota: 20
      maximální hodnota: 100
      Váš účet bude účtován za každý SERP obsahující až 20 výsledků;
      nastavení hloubky nad 20 může vést k dodatečným poplatkům, pokud vyhledávač vrátí více než 20 výsledků;
      pokud je zadaná hloubka vyšší než počet otázek v odpovědi, rozdíl vám bude automaticky vrácen na zůstatek účtu;
      náklady lze vypočítat na stránce Ceny.

    • keyword
      Typ: string

      klíčové slovo
      povinné pole
      zadané klíčové slovo by mělo označovat název místní provozovny
      do pole keyword můžete zadat až 700 znaků
      všechny řetězce %## budou dekódovány (znak „+“ bude dekódován jako mezera)
      pokud potřebujete v keyword použít znak „%“, zadejte jej jako „%25“;

      toto pole lze také použít k předání následujících parametrů:
      cid - jedinečné ID obchodního subjektu definované Googlem;
      place_id - identifikátor obchodního subjektu v Google Maps;

      příklad:
      cid:194604053573767737
      place_id:GhIJQWDl0CIeQUARxks3icF8U8A

      více o identifikátorech cid a place_id v tomto článku nápovědy

      více o pravidlech a omezeních polí keyword a keywords v rozhraních DataForSEO najdete v tomto článku nápovědy

    • language_code
      Typ: string

      kód jazyka vyhledávače
      povinné pole, pokud nezadáte language_name
      pokud toto pole použijete, nemusíte zadávat language_name
      seznam dostupných jazyků s jejich language_code získáte samostatným požadavkem na https://api.dataforseo.com/v3/business_data/google/languages
      příklad:
      en

    • language_name
      Typ: string

      úplný název jazyka vyhledávače
      povinné pole, pokud nezadáte language_code
      pokud toto pole použijete, nemusíte zadávat language_code
      seznam dostupných jazyků s language_name získáte samostatným požadavkem na https://api.dataforseo.com/v3/business_data/google/languages
      příklad:
      English

    • location_code
      Typ: integer

      kód lokality vyhledávače
      povinné pole, pokud nezadáte location_name nebo location_coordinate
      pokud toto pole použijete, nemusíte zadávat location_name ani location_coordinate
      seznam dostupných lokalit s location_code získáte samostatným požadavkem na https://api.dataforseo.com/v3/business_data/google/locations
      příklad:
      2840

    • location_coordinate
      Typ: string

      GPS souřadnice lokality
      povinné pole, pokud nezadáte location_name nebo location_code
      pokud toto pole použijete, nemusíte zadávat location_name ani location_code
      parametr location_coordinate je nutné zadat ve formátu "latitude,longitude,radius"
      maximální počet desetinných míst pro "latitude" a "longitude": 7
      minimální hodnota "radius": 199.9 (mm)
      maximální hodnota "radius": 199999 (mm)
      příklad:
      53.476225,-2.243572,200

    • location_name
      Typ: string

      úplný název lokality vyhledávače
      povinné pole, pokud nezadáte location_code nebo location_coordinate
      pokud toto pole použijete, nemusíte zadávat location_code ani location_coordinate
      seznam dostupných lokalit s location_name získáte samostatným požadavkem na https://api.dataforseo.com/v3/business_data/google/locations
      příklad:
      London,England,United Kingdom

    • tag
      Typ: string | null

      uživatelem definovaný identifikátor úlohy
      volitelné pole
      limit znaků je 255
      tento parametr můžete použít k identifikaci úlohy a jejímu spárování s výsledkem
      zadanou hodnotu tag najdete v objektu data odpovědi

Odpovědi
  • 200
    Typ: object | null · Response36Afe1097B20_BusinessDataGoogleQuestionsAndAnswersLiveResponseInfo
    • cost
      Typ: number | null Formát: double

      celkové náklady na úlohy, USD

    • status_code
      Typ: integer | null

      obecný kód stavu úplný seznam kódů odpovědí najdete zde

    • status_message
      Typ: string | null

      obecná informační zpráva úplný seznam obecných informačních zpráv najdete zde

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

      pole úloh

      • Typ: object | null · Response36Afe1097B20_BusinessDataGoogleQuestionsAndAnswersLiveTaskInfo
        • cost
          Typ: number | null Formát: double

          celkové náklady na úlohy, USD

        • data
          Typ: object | null

          obsahuje stejné parametry, které jste zadali v požadavku POST

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

          identifikátor úlohy jedinečný identifikátor úlohy v našem systému ve formátu UUID

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

          cesta URL

        • result
          Typ: array (object | null)[] | null

          pole výsledků

          • check_url
            Typ: string | null

            přímá adresa URL na výsledky vyhledávače
            můžete ji použít k ověření, že jsme poskytli přesné výsledky

          • cid
            Typ: string | null

            klientské ID definované Googlem
            jedinečné ID místní provozovny;
            více o identifikátoru najdete v tomto článku nápovědy

          • datetime
            Typ: string | null

            datum a čas přijetí výsledku
            ve formátu UTC: „yyyy-mm-dd hh-mm-ss +00:00”
            příklad:
            2019-11-15 12:57:46 +00:00

          • feature_id
            Typ: string | null

            jedinečný identifikátor funkce SERP

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

            typy prvků
            typy výsledků vyhledávání nalezené v poli items;
            možné typy prvků: google_business_question_item

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

            pole prvků
            prvky v google_business_question_item

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

              pole prvků
              prvky v google_business_question_item

              • answer_id
                Typ: string | null

                ID odpovědi

              • answer_text
                Typ: string | null

                aktuální text odpovědi

              • original_answer_text
                Typ: string | null

                původní text odpovědi

              • profile_image_url
                Typ: string | null

                URL profilového obrázku uživatele

              • profile_name
                Typ: string | null

                zobrazované jméno uživatele

              • profile_url
                Typ: string | null

                URL profilu uživatele

              • time_ago
                Typ: string | null

                odhadovaný čas publikace odpovědi

              • timestamp
                Typ: string | null

                přesný čas publikace odpovědi

              • type
                Typ: string | null

                typ prvku

            • original_question_text
              Typ: string | null

              původní text otázky

            • profile_image_url
              Typ: string | null

              URL profilového obrázku uživatele

            • profile_name
              Typ: string | null

              zobrazované jméno uživatele

            • profile_url
              Typ: string | null

              URL profilu uživatele

            • question_id
              Typ: string | null

              ID otázky

            • question_text
              Typ: string | null

              aktuální text otázky

            • rank_absolute
              Typ: integer | null

              absolutní pořadí mezi všemi prvky

            • rank_group
              Typ: integer | null

              pozice ve skupině prvků se shodnými hodnotami type
              pozice prvků s odlišnými hodnotami type se v rank_group vynechávají

            • time_ago
              Typ: string | null

              odhadovaný čas položení otázky

            • timestamp
              Typ: string | null

              přesný čas položení otázky

            • type
              Typ: string | null

              typ prvku

            • url
              Typ: string | null

              URL otázky

          • items_count
            Typ: integer | null Formát: int64

            počet prvků v poli items

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

            pole položek otázek Google Business bez odpovědí

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

              pole prvků
              prvky v google_business_question_item

              • answer_id
                Typ: string | null

                ID odpovědi

              • answer_text
                Typ: string | null

                aktuální text odpovědi

              • original_answer_text
                Typ: string | null

                původní text odpovědi

              • profile_image_url
                Typ: string | null

                URL profilového obrázku uživatele

              • profile_name
                Typ: string | null

                zobrazované jméno uživatele

              • profile_url
                Typ: string | null

                URL profilu uživatele

              • time_ago
                Typ: string | null

                odhadovaný čas publikace odpovědi

              • timestamp
                Typ: string | null

                přesný čas publikace odpovědi

              • type
                Typ: string | null

                typ prvku

            • original_question_text
              Typ: string | null

              původní text otázky

            • profile_image_url
              Typ: string | null

              URL profilového obrázku uživatele

            • profile_name
              Typ: string | null

              zobrazované jméno uživatele

            • profile_url
              Typ: string | null

              URL profilu uživatele

            • question_id
              Typ: string | null

              ID otázky

            • question_text
              Typ: string | null

              aktuální text otázky

            • rank_absolute
              Typ: integer | null

              absolutní pořadí mezi všemi prvky

            • rank_group
              Typ: integer | null

              pozice ve skupině prvků se shodnými hodnotami type
              pozice prvků s odlišnými hodnotami type se v rank_group vynechávají

            • time_ago
              Typ: string | null

              odhadovaný čas položení otázky

            • timestamp
              Typ: string | null

              přesný čas položení otázky

            • type
              Typ: string | null

              typ prvku

            • url
              Typ: string | null

              URL otázky

          • keyword
            Typ: string | null

            klíčové slovo obdržené v poli POST
            klíčové slovo se vrací s dekódovaným %## (znak plus '+' bude dekódován jako mezera)
            toto pole bude obsahovat parametr cid, pokud jej zadáte v poli keyword při nastavování úlohy;
            příklad:
            cid:2946633002421908862
            více o parametru najdete v tomto článku nápovědy

          • language_code
            Typ: string | null

            kód jazyka v poli POST

          • location_code
            Typ: integer | null

            kód lokality v poli POST

          • se_domain
            Typ: string | null

            doména vyhledávače zadaná v poli POST

        • result_count
          Typ: integer | null Formát: int64

          počet prvků v poli result

        • status_code
          Typ: integer | null

          stavový kód úlohy vygenerovaný DataForSEO; může být v následujícím rozsahu: 10000-60000 úplný seznam kódů odpovědí najdete zde

        • status_message
          Typ: string | null

          informační zpráva úlohy úplný seznam obecných informačních zpráv najdete zde

        • time
          Typ: string | null

          doba provedení, sekundy

    • tasks_count
      Typ: integer | null Formát: int64

      počet úloh v poli tasks

    • tasks_error
      Typ: integer | null Formát: int64

      počet úloh v poli tasks vrácených s chybou

    • time
      Typ: string | null

      celková doba provádění, sekundy

    • version
      Typ: string | null

      aktuální verze API

    application/json
  • 400

    Požadavek se nepodařilo zpracovat. Zkontrolujte parametry požadavku.

  • 401

    Je vyžadován platný API klíč Felo.

  • 402

    V požadavku nelze pokračovat, protože není splněn požadavek na fakturaci.

  • 403

    Účet nemá oprávnění tuto operaci provést.

  • 429

    Byl dosažen limit požadavků nebo útraty.

  • 502

    Služba nemohla požadavek dokončit.

  • 503

    API nebo fakturační služba je dočasně nedostupná.

  • 504

    Při zpracování požadavku vypršel časový limit služby.

  • default

    Chybová odpověď; odpovědi předávané přímo od upstream poskytovatele mohou používat formáty poskytovatele

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

Úspěšná operace

Setting Live Google My Business Questions and Answers Tasks