DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Nastavení úloh recenzí aplikace Google
Zařadí recenze jedné aplikace Google Play podle app_id a vrátí id úlohy. depth určuje, kolik jich shromáždit. 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. Načtěte pomocí get_dataforseo_app_google_app_reviews_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)[]
- appTyp: string
_id identifikátor aplikace
povinné pole
ID mobilní aplikace v Google Play;
identifikátor najdete v URL každé aplikace uvedené v Google Play;
příklad:https://play.google.com/store/apps/details?id=org.telegram.messenger - depthTyp: integer | null
hloubka parsování
volitelné pole
počet recenzí vrácených v odpovědi API;
důrazně doporučujeme nastavovat hloubku parsování v násobcích 150, protože náš systém zpracovává 150 recenzí za sebou;
výchozí hodnota:150;
maximální hodnota:100000;
Váš účet bude účtován za každý SERP obsahující až 150 výsledků;
nastavení hloubky nad 150 může vést k dodatečným poplatkům, pokud vyhledávač vrátí více než 150 výsledků;
Náklady lze vypočítat na stránce Ceny. - languageTyp: string
_code kód jazyka vyhledávače
povinné pole, pokud nezadátelanguage_name
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
_name úplný název jazyka vyhledávače
povinné pole, pokud nezadátelanguage_code
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
- ratingTyp: integer | null
filtrování recenzí podle hodnocení
volitelné pole
pomocí tohoto pole můžete filtrovat výsledky;
možné typy filtrování:5— vrací pouze recenze s hodnocením pěti hvězdiček;4— vrací pouze recenze s hodnocením čtyř hvězdiček;3— vrací pouze recenze s hodnocením tří hvězdiček;2— vrací pouze recenze s hodnocením dvou hvězdiček;1— vrací pouze recenze s hodnocením jedné hvězdičky;
ve výchozím nastavení API vrací všechny recenze bez ohledu na počet hvězdiček - sortTyp: string | null
_by parametry řazení výsledků
volitelné pole
pomocí tohoto pole můžete výsledky řadit;
možné typy řazení:newest— řazení podle nejnovějších recenzí;most_relevant— řazení podle nejrelevantnějších recenzí;
výchozí pravidlo:most_relevant - 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_AppDataGoogleAppReviewsTaskPostResponseInfo200
- 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_AppDataGoogleAppReviewsTaskPostTaskInfo
- 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_reviews/task_post \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"app_id": "org.telegram.messenger",
"location_code": 2840,
"language_code": "en",
"depth": 150
}
]'
{
"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
}
]
}