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

Vytváření úloh SERP vyhledávání Google Ads

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 SERP vyhledávání Google Ads

​

Zařadí do fronty reklamy zobrazované na klíčové slovo v Google a vrátí id úlohy v tasks[0].id. Zabaleno 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. Živý protějšek odpovídá okamžitě a pro jedno hledání je jednodušší; do fronty zařazujte, když by dávka překonala trpělivost volání nástroje.

Cenová reference

  • Účtování: nahlášené náklady na odpověď.
  • Referenční odhad požadavku: USD 0.02.
  • 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 či 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)[]
    • advertiser_ids
      Typ: array string[]

      identifikátory inzerentů

      povinné pole, pokud není zadán target


      v tomto poli můžete zadat maximálně 25 hodnot;

      hodnoty advertiser_ids pro tento parametr najdete v endpointu Google Ads Advertisers;

    • date_from
      Typ: string

      počáteční datum časového rozsahu

      volitelné pole

      povinné pole, pokud je zadáno date_to;


      formát data: "yyyy-mm-dd"

      minimální hodnota: 2018-05-31

      maximální hodnota: dnešní datum

      příklad:

      "2020-01-01"

    • date_to
      Typ: string

      koncové datum časového rozsahu

      volitelné pole

      povinné pole, pokud je zadáno date_from;


      formát data: "yyyy-mm-dd"

      minimální hodnota: 2018-05-31

      maximální hodnota: dnešní datum

      příklad:

      "2020-01-01"

    • depth
      Typ: integer | null

      hloubka parsování

      volitelné pole

      počet výsledků v SERP

      výchozí hodnota: 40

      maximální hodnota: 700


      Váš účet bude účtován za každý SERP obsahující až 40 výsledků;

      Nastavení hloubky nad 40 může vést k dodatečným poplatkům pokud vyhledávač vrátí více než 40 výsledků;

      Náklady lze vypočítat na stránce Ceny.

    • format
      Typ: string | null

      formát reklamy

      volitelné pole

      možné hodnoty: all, text, image, video

    • location_code
      Typ: integer | null

      kód lokality vyhledávače

      volitelné pole

      pokud toto pole použijete, nemusíte zadávat location_name nebo location_coordinate

      seznam dostupných lokalit vyhledávačů s jejich location_code získáte samostatným požadavkem na https://api.dataforseo.com/v3/serp/google/ads_search/locations

      příklad:

      2840


      Poznámka: pokud nezadáte location_name, location_code ani location_coordinate, reklamy budou vyhledávány ve všech dostupných lokalitách

    • location_coordinate
      Typ: string | null

      GPS souřadnice lokality

      volitelné pole

      pokud toto pole použijete, nemusíte zadávat location_name nebo location_code

      příklad:

      52.6178549,-155.352142


      Poznámka: pokud nezadáte location_name, location_code ani location_coordinate, reklamy budou vyhledávány ve všech dostupných lokalitách

    • location_name
      Typ: string | null

      úplný název lokality vyhledávače

      volitelné pole

      pokud toto pole použijete, nemusíte zadávat location_code nebo location_coordinate

      seznam dostupných lokalit vyhledávače s jejich location_name získáte samostatným požadavkem na https://api.dataforseo.com/v3/serp/google/ads_search/locations

      příklad:

      London,England,United Kingdom


      Poznámka: pokud nezadáte location_name, location_code ani location_coordinate, reklamy budou vyhledávány ve všech dostupných lokalitách

    • pingback_url
      Typ: string | null

      URL oznámení o dokončené úloze

      volitelné pole

      po dokončení úlohy vás upozorníme požadavkem GET odeslaným na zadanou URL

      řetězec ‘$id’ můžete použít jako proměnnou $id a ‘$tag’ jako proměnnou $tag kódovanou v URL. Před odesláním požadavku nastavíme potřebné hodnoty.

      příklad:

      http://your-server.com/pingscript?id=$id

      http://your-server.com/pingscript?id=$id&tag=$tag

      Poznámka: speciální znaky v pingback_url budou kódovány v URL;

      např. znak # bude zakódován jako %23


      další informace najdete v našem Centru nápovědy

    • platform
      Typ: string | null

      reklamní platforma

      volitelné pole

      možné hodnoty: all, google_play, google_maps, google_search, google_shopping, youtube

      výchozí hodnota: all

    • postback_data
      Typ: string

      datový typ postback_url

      povinné pole, pokud zadáte postback_url

      odpovídá funkci, kterou jste použili k nastavení úlohy

      možné hodnoty:

      advanced

    • postback_url
      Typ: string | null

      URL pro odesílání výsledků úlohy

      volitelné pole

      po dokončení úlohy odešleme požadavek POST s výsledky komprimovanými ve formátu gzip na zadanou postback_url

      řetězec ‘$id’ můžete použít jako proměnnou $id a ‘$tag’ jako proměnnou $tag kódovanou v URL. Před odesláním požadavku nastavíme potřebné hodnoty.

      příklad:

      http://your-server.com/postbackscript?id=$id

      http://your-server.com/postbackscript?id=$id&tag=$tag

      Poznámka: speciální znaky v postback_url budou kódovány v URL;

      mj. znak # bude zakódován jako %23


      další informace najdete v Centru nápovědy

    • priority
      Typ: integer | null

      priorita úlohy

      volitelné pole

      může nabývat následujících hodnot:

      1 – normální priorita provedení (nastaveno ve výchozím nastavení)

      2 – vysoká priorita provedení


      Za úlohy s vysokou prioritou provedení bude účtován příplatek.

      Náklady lze vypočítat na stránce Ceny.

    • tag
      Typ: string | null

      identifikátor úlohy definovaný uživatelem

      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

    • target
      Typ: string

      název domény

      povinné pole, pokud není zadán advertiser_ids

      název domény přidružený k účtu inzerenta

Odpovědi
  • 200
    Typ: object | null · Response36Afe1097B20_SerpGoogleAdsSearchTaskPostResponseInfo
    • 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_SerpGoogleAdsSearchTaskPostTaskInfo
        • 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: object | null

          pole výsledků
          v tomto případě bude hodnota null

        • 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/serp/google/ads_search/task_post
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/ads_search/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "location_code": 2840,
    "platform": "google_search",
    "advertiser_ids": [
      "AR13752565271262920705",
      "AR02439908557932462081"
    ]
  }
]'

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

Úspěšná operace

Setting Google Ads Search SERP Tasks