Nastavení úloh vyhledávání aplikací Google
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Nastavení úloh vyhledávání aplikací Google
Zařadí vyhledávání v Google Play pro keyword a vrátí id úlohy. Utvářejí je location_code, language_code a depth. Asynchronně: odeslání vrátí id úlohy v tasks[0].id a nástroj pro načtení vrátí výsledek, jakmile je připraven. location_code 2840 jsou Spojené státy. Načtěte pomocí get_dataforseo_app_google_app_searches_fetch.
Cenová reference
- Účtování: nahlášené náklady na odpověď.
- Referenční odhad požadavku: USD 0.012.
- 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.
- Typ: array (object | null)[]
- depthTyp: integer | null
hloubka parsování
volitelné pole
počet výsledků vrácených ze SERP Google Play;
důrazně doporučujeme nastavovat hloubku parsování v násobcích 30, protože náš systém zpracovává 30 výsledků za sebou;
výchozí hodnota:30;
maximální hodnota:200;
Váš účet bude účtován za každý SERP obsahující až 30 výsledků;
nastavení hloubky nad 30 může vést k dodatečným poplatkům, pokud vyhledávač vrátí více než 30 výsledků;
Náklady lze vypočítat na stránce Ceny. - keywordTyp: string
klíčové slovo
povinné pole
do polekeywordmůžete zadat až 700 znaků;
všechny řetězce %## budou dekódovány (znak „+” bude dekódován jako mezera);
pokud potřebujete znak „%” vkeyword, zadejte jej jako „%25”;
pokud potřebujete znak „+” vkeyword, zadejte jej jako „%2B”více o pravidlech a omezeních polí
keywordakeywordsv rozhraních API DataForSEO najdete v tomto článku nápovědy - languageTyp: string | null
_code kód jazyka vyhledávače
volitelné pole
pokud toto pole použijete, nemusíte zadávatlanguage_name
seznam dostupných jazyků s jejichlanguage_codemůžete získat samostatným požadavkem nahttps://api.dataforseo.com/v3/app_data/google/languages
příklad:en - languageTyp: string | null
_name úplný název jazyka vyhledávače
volitelné pole
pokud toto pole použijete, nemusíte zadávatlanguage_code
seznam dostupných jazyků s jejichlanguage_namemůžete získat samostatným požadavkem nahttps://api.dataforseo.com/v3/app_data/google/languages
příklad:English - locationTyp: integer
_code kód lokality vyhledávače
povinné pole, pokud nezadátelocation_name
pokud toto pole použijete, nemusíte zadávatlocation_name
seznam dostupných lokalit vyhledávače s jejichlocation_codemůžete získat samostatným požadavkem nahttps://api.dataforseo.com/v3/app_data/google/locations
příklad:9061121 - locationTyp: string
_name úplný název lokality vyhledávače
povinné pole, pokud nezadátelocation_code
pokud toto pole použijete, nemusíte zadávatlocation_code
seznam dostupných lokalit vyhledávače s jejichlocation_namemůžete získat samostatným požadavkem nahttps://api.dataforseo.com/v3/app_data/google/locations
příklad:West Los Angeles,California,United States - pingbackTyp: string | null
_url URL oznámení o dokončení úlohy
volitelné pole
po dokončení úlohy vás budeme informovat požadavkem GET odeslaným na vámi zadanou URL
řetězec „$id” můžete použít jako proměnnou$ida „$tag” jako proměnnou$tagkódovanou v URL. Před odesláním požadavku nastavíme potřebné hodnoty.
příklad:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Poznámka: speciální znaky vpingback_urlbudou kódovány v URL;
mj. znak#bude zakódován jako%23 - postbackTyp: string
_data datový typ postback_url
povinné pole, pokud zadátepostback_url
odpovídá datovému typu, který bude odeslán na váš server
možné hodnoty:advanced,html - postbackTyp: string | null
_url 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átugzipna vámi zadanoupostback_url
řetězec „$id” můžete použít jako proměnnou$ida „$tag” jako proměnnou$tagkódovanou v URL. Před odesláním požadavku nastavíme potřebné hodnoty.
příklad:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Poznámka: speciální znaky vpostback_urlbudou kódovány v URL;
mj. znak#bude zakódován jako%23 - priorityTyp: integer | null
- tagTyp: 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 hodnotutagnajdete v objektudataodpovědi
- Typ: object | null · Response36Afe1097B20_AppDataGoogleAppSearchesTaskPostResponseInfo200
- Typ: number | null Formát: doublecost
celkové náklady na úlohy, USD
- Typ: integer | nullstatus
_code obecný kód stavu úplný seznam kódů odpovědí najdete zde
- Typ: string | nullstatus
_message obecná informační zpráva úplný seznam obecných informačních zpráv najdete zde
- Typ: array (object | null)[] | nulltasks
pole úloh
- Typ: object | null · Response36Afe1097B20_AppDataGoogleAppSearchesTaskPostTaskInfo
- costTyp: number | null Formát: double
celkové náklady na úlohy, USD
- dataTyp: object | null
obsahuje stejné parametry, které jste zadali v požadavku POST
- propertyTyp: object | null
Name
- idTyp: string | null
identifikátor úlohy jedinečný identifikátor úlohy v našem systému ve formátu UUID
- pathTyp: array (string | null)[] | null
cesta URL
- resultTyp: object | null
pole výsledků
v tomto případě bude hodnotanull - resultTyp: integer | null Formát: int64
_count počet prvků v poli result
- statusTyp: integer | null
_code 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
- statusTyp: string | null
_message informační zpráva úlohy úplný seznam obecných informačních zpráv najdete zde
- timeTyp: string | null
doba provedení, sekundy
- Typ: integer | null Formát: int64tasks
_count počet úloh v poli tasks
- Typ: integer | null Formát: int64tasks
_error počet úloh v poli tasks vrácených s chybou
- Typ: string | nulltime
celková doba provádění, sekundy
- Typ: string | nullversion
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
curl https://openapi.felo.ai/v1/beta/dataforseo/app_data/google/app_searches/task_post \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"keyword": "vpn",
"location_code": 2840,
"language_code": "en",
"depth": 30
}
]'
{
"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
}
]
}