sklik rozsireni na typove metody
This commit is contained in:
+37
@@ -39,6 +39,7 @@ služba si nic neukládá. Vyplníte je v Swaggeru po kliknutí na **Try it out*
|
||||
| Google Ads | `X-GAds-Login-Customer-Id`, `X-GAds-Quota-Project` | ne |
|
||||
| Sklik | `X-Sklik-Token` | ano |
|
||||
| Sklik | `X-Sklik-User-Id` | ne (jen pro agenturní/MCC přístup) |
|
||||
| Sklik – zápis | `X-Idempotency-Key` | ne (doporučeno, viz níže) |
|
||||
|
||||
Tři Google služby používají stejný princip přihlášení (Google OAuth) – liší se
|
||||
jen prefixem hlavičky a oprávněním (scope). **Jeden service account lze použít
|
||||
@@ -115,6 +116,42 @@ standardní hlavičce `Authorization: Bearer <token>`.
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ Sklik – správa kampaní (zápis)
|
||||
|
||||
Plné CRUD nad kampaněmi, sestavami a inzeráty. Tělo je **pole struktur** podle
|
||||
[dokumentace Skliku](https://api.sklik.cz/drak/campaigns.create.html); dávka je
|
||||
all-or-nothing.
|
||||
|
||||
| Operace | Endpoint |
|
||||
| --- | --- |
|
||||
| Založení | `POST /sklik/{campaigns\\|groups\\|ads}` |
|
||||
| Úprava | `PUT /sklik/{campaigns\\|groups\\|ads}` (povinné `id`) |
|
||||
| Smazání | `DELETE /sklik/{campaigns\\|groups\\|ads}?ids=1,2` |
|
||||
| Obnovení | `POST /sklik/{campaigns\\|groups\\|ads}/restore?ids=1,2` |
|
||||
|
||||
- **Vše se zakládá pauznuté.** Sklik má výchozí `status: active`, takže
|
||||
neuvedený stav by znamenal živou kampaň – proxy proto při zakládání vždy
|
||||
vynutí `status: "suspend"` a jinou hodnotu ignoruje.
|
||||
- **`PUT` status nevynucuje** – tím se kampaň pozastavuje (`suspend`) i
|
||||
spouští (`active`). Pokud má aktivace zůstat výhradně ruční, nastavte
|
||||
`SKLIK_BLOCK_ACTIVATION=true`; pak je `active` odmítnuto s 403.
|
||||
- **Mazání je vratné** – Sklik entitu jen označí jako smazanou, `/restore` ji vrátí.
|
||||
- **U inzerátů** platí, že změna kreativy (nadpisy, popis, URL) starý inzerát
|
||||
smaže a založí nový – **inzerát dostane nové `id`**.
|
||||
- **Částky jsou v haléřích** (100 = 1 Kč). `dayBudget: 20000` = 200 Kč/den.
|
||||
- **`X-Idempotency-Key`** (volitelné, doporučené): při opakovaném odeslání se
|
||||
stejným klíčem se vrátí původní výsledek místo zopakování zápisu.
|
||||
- **Stropy rozpočtů** jsou ve výchozím stavu **vypnuté**. Zapínají se
|
||||
proměnnými `SKLIK_MAX_DAY_BUDGET_HALERS`, `SKLIK_MAX_TOTAL_BUDGET_HALERS`
|
||||
a `SKLIK_MAX_CPC_HALERS`. Co je aktuálně nastavené, ukáže
|
||||
`GET /sklik/write-limits`.
|
||||
|
||||
Číst strukturu účtu lze přes `GET /sklik/campaigns`, `/sklik/groups`,
|
||||
`/sklik/ads` (stránkování řeší proxy), statistiky přes `POST
|
||||
/sklik/report/{entity}`.
|
||||
|
||||
---
|
||||
|
||||
Podrobnosti k jednotlivým endpointům jsou v `documentation/` v repozitáři.
|
||||
""".strip()
|
||||
|
||||
|
||||
Reference in New Issue
Block a user