# Nastavení úloh SERP Google Events

**API:** Data API

**Endpoint:** `POST /v1/beta/dataforseo/serp/google/events/task_post`

**Tags:** DataForSEO

Zařadí do fronty události, které Google u dotazu zobrazuje, 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á verze odpovídá okamžitě a u jediného dotazu je jednodušší; do fronty zařaďte, když by dávka trvala déle než 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. Neaplikujte jej znovu na 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.

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Request body

Required: **yes**

### application/json

Schema:

```json
{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "keyword": {
        "type": "string",
        "description": "Klíčové slovo k vyhledání"
      },
      "location_code": {
        "type": "integer",
        "description": "Kód lokality vyhledávače"
      },
      "location_name": {
        "type": "string",
        "description": "Úplný název lokality vyhledávače"
      },
      "location_coordinate": {
        "type": "string",
        "description": "GPS souřadnice lokality"
      },
      "language_code": {
        "type": "string",
        "description": "Kód jazyka vyhledávače"
      },
      "language_name": {
        "type": "string",
        "description": "Úplný název jazyka vyhledávače"
      },
      "priority": {
        "type": "integer",
        "description": "Priorita úlohy"
      },
      "postback_url": {
        "type": "string",
        "description": "URL pro odesílání výsledků úlohy"
      },
      "pingback_url": {
        "type": "string",
        "description": "URL oznámení o dokončené úloze"
      },
      "postback_data": {
        "type": "string",
        "description": "Datový typ postback"
      }
    },
    "required": [
      "keyword"
    ]
  }
}
```

## Responses

### 200 — Úspěšná odpověď

Headers:
- `X-Request-Id` (string) — Identifikátor požadavku, který je třeba uvést při kontaktování podpory Felo.

**application/json**

Schema: object

```json
{
  "type": "object",
  "properties": {
    "version": {
      "type": "string",
      "description": "Aktuální verze API"
    },
    "status_code": {
      "type": "integer",
      "description": "Obecný kód stavu"
    },
    "status_message": {
      "type": "string",
      "description": "Obecná informační zpráva"
    },
    "time": {
      "type": "string",
      "description": "Doba provedení, sekundy"
    },
    "cost": {
      "type": "number",
      "description": "Celkové náklady na úlohy, USD"
    },
    "tasks_count": {
      "type": "integer",
      "description": "Počet úloh v poli úloh"
    },
    "tasks_error": {
      "type": "integer",
      "description": "Počet úloh v poli úloh vrácených s chybou"
    },
    "tasks": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Pole objektů úloh"
    },
    "tasks[].id": {
      "type": "string",
      "description": "Identifikátor úlohy ve formátu UUID"
    },
    "tasks[].status_code": {
      "type": "integer",
      "description": "Kód stavu úlohy"
    },
    "tasks[].status_message": {
      "type": "string",
      "description": "Zpráva o stavu úlohy"
    },
    "tasks[].cost": {
      "type": "number",
      "description": "Náklady na úlohu, USD"
    },
    "tasks[].result_count": {
      "type": "integer",
      "description": "Počet prvků v poli výsledků"
    }
  }
}
```

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

Schema:

```json
{}
```
