v0.2.0-beta

OpenAPI 3.1.0

Vytváření úloh recenzí Google Shopping

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

post/v1/beta/dataforseo/merchant/google/reviews/task_post

Vytváření úloh recenzí Google Shopping

Zařadí recenze jednoho produktu Google Shopping a vrátí id úlohy. Produkt určete pomocí product_id plus gid nebo data_docid z výsledku produktů. Celá tato rodina je 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_merchant_google_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.

Tělo

povinné

application/json

Typ: array object[]
- Typ: object
  gid
  Typ: string
  povinné
  
  globální identifikátor produktu na Google Shopping. Povinné pole. Pro optimální výsledky doporučujeme zadat gid společně s data_docid a product_id; tuto hodnotu pro určitý produkt získáte samostatným požadavkem na endpoint Google Shopping Products. Příklad: 4702526954592161872. Další informace o parametru najdete v tomto průvodci Centra nápovědy.
  
  data_docid
  Typ: string
  
  jedinečný identifikátor datového prvku SERP. Volitelné pole. Pro optimální výsledky doporučujeme zadat data_docid společně s product_id a gid; tuto hodnotu pro určitý prvek získáte samostatným požadavkem na endpoint Google Shopping Products. Příklad: 13071766526042404278.
  
  depth
  Typ: integer
  
  hloubka analýzy. Volitelné pole. Počet recenzí v SERP; důrazně doporučujeme nastavit hloubku analýzy v násobcích deseti, protože náš systém zpracovává deset recenzí za sebou. Maximální hodnota: 8000. Výchozí hodnota: 10. Váš účet bude účtován za každý SERP obsahující až 10 výsledků; nastavení hloubky nad 10 může vést k dodatečným poplatkům, pokud vyhledávač vrátí více než 10 výsledků. Náklady lze vypočítat na stránce Ceny.
  
  language_code
  Typ: string
  
  kód jazyka vyhledávače. Povinné pole, pokud nezadáte language_name. Pokud toto pole použijete, nemusíte zadávat language_name. Seznam dostupných jazyků s jejich parametry language_code získáte samostatným požadavkem na https://api.dataforseo.com/v3/merchant/google/languages. Příklad: en_GB.
  
  language_name
  Typ: string
  
  úplný název jazyka vyhledávače. Povinné pole, pokud nezadáte language_code. Pokud toto pole použijete, nemusíte zadávat language_code. Seznam dostupných jazyků s jejich parametry language_name získáte samostatným požadavkem na https://api.dataforseo.com/v3/merchant/google/languages. Příklad: English (United Kingdom).
  
  location_code
  Typ: integer
  
  kód lokality vyhledávače. Povinné pole, pokud nezadáte location_name nebo location_coordinate. Pokud toto pole použijete, nemusíte zadávat location_name ani location_coordinate. Seznam dostupných lokalit s jejich parametry location_code získáte samostatným požadavkem na https://api.dataforseo.com/v3/merchant/google/locations. Příklad: 9045969.
  
  location_coordinate
  Typ: string
  
  GPS souřadnice lokality. Povinné pole, pokud nezadáte location_name nebo location_code. Pokud toto pole použijete, nemusíte zadávat location_name ani location_code. Parametr location_coordinate je nutné zadat ve formátu „latitude,longitude,radius“. Maximální počet desetinných míst pro „latitude“ a „longitude“: 7. Minimální hodnota pro „radius“: 199.9. Příklad: 53.476225,-2.243572,200.
  
  location_name
  Typ: string
  
  úplný název lokality vyhledávače. Povinné pole, pokud nezadáte location_code nebo location_coordinate. Pokud toto pole použijete, nemusíte zadávat location_code ani location_coordinate. Seznam dostupných lokalit s jejich parametry location_name získáte samostatným požadavkem na https://api.dataforseo.com/v3/merchant/google/locations. Příklad: HA1,England,United Kingdom.
  
  pingback_url
  Typ: string
  
  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 můžete použít řetězec ‘$id’ jako proměnnou $id a ‘$tag’ jako proměnnou $tag kódovanou v URL. Potřebné hodnoty nastavíme před odesláním požadavku. 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; mj. znak # bude zakódován jako %23 více informací najdete v našem Centru nápovědy
  
  postback_data
  Typ: string
  
  datový typ postback_url volitelné pole odpovídá datovému typu, který bude odeslán na váš server možné hodnoty: advanced
  
  postback_url
  Typ: string
  
  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 adresu postback_url můžete použít řetězec ‘$id’ jako proměnnou $id a ‘$tag’ jako proměnnou $tag kódovanou v URL. Potřebné hodnoty nastavíme před odesláním požadavku. 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 více informací najdete v našem Centru nápovědy
  
  priority
  Typ: integer
  
  priorita úlohy volitelné pole může nabývat následujících hodnot: 1 – normální priorita provedení (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 s cenami.
  
  product_id
  Typ: string
  
  jedinečný identifikátor produktu v Google Shopping volitelné pole doporučujeme uvádět product_id společně s data_docid a gid pro optimální výsledky; tuto hodnotu pro konkrétní produkt můžete získat samostatným požadavkem na endpoint Google Shopping Products příklad: 4485466949985702538 více informací o parametru v této příručce Centra nápovědy
  
  se_domain
  Typ: string
  
  doména vyhledávače volitelné pole příslušnou doménu vyhledávače volíme automaticky podle zadané lokalizace a jazyka v tomto poli však můžete nastavit vlastní doménu vyhledávače příklad: google.co.uk, google.com.au, google.de atd.
  
  tag
  Typ: string
  
  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 hodnotu tag najdete v objektu data odpovědi
  
  Prázdný objekt
  Prázdný objekt

Odpovědi

200
Typ: object

Úspěšná odpověď
cost
Typ: number

celkové náklady na úlohy, USD

status_code
Typ: integer

obecný kód stavu. Úplný seznam kódů odpovědí najdete zde. Poznámka: důrazně doporučujeme navrhnout systém pro zpracování souvisejících výjimečných nebo chybových stavů

status_message
Typ: string

obecná informační zpráva. Úplný seznam obecných informačních zpráv najdete zde

tasks
Typ: array string[]

pole úloh

tasks_count
Typ: integer

počet úloh v poli tasks

tasks_error
Typ: integer

počet úloh v poli tasks vrácených s chybou

tasks.cost
Typ: number

náklady na úlohu, USD

tasks.data
Typ: object

obsahuje stejné parametry, které jste zadali v požadavku POST

tasks.id
Typ: string

jedinečný identifikátor úlohy v našem systému ve formátu univerzálně jedinečného identifikátoru (UUID)

tasks.path
Typ: array string[]

cesta URL

tasks.result
Typ: array string[]

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

tasks.result_count
Typ: integer

počet prvků v poli result

tasks.status_code
Typ: integer

kód stavu úlohy vygenerovaný DataForSEO; může být v rozsahu: 10000-60000

tasks.status_message
Typ: string

informační zpráva úlohy

tasks.time
Typ: string

doba provedení, sekundy

time
Typ: string

doba provedení, sekundy

version
Typ: string

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

post/v1/beta/dataforseo/merchant/google/reviews/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/merchant/google/reviews/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {},
  {}
]'

Zobrazit schéma

{
  "version": "string",
  "status_code": 1,
  "status_message": "string",
  "time": "string",
  "cost": 1,
  "tasks_count": 1,
  "tasks_error": 1,
  "tasks": [
    "string"
  ],
  "tasks.id": "string",
  "tasks.status_code": 1,
  "tasks.status_message": "string",
  "tasks.time": "string",
  "tasks.cost": 1,
  "tasks.result_count": 1,
  "tasks.path": [
    "string"
  ],
  "tasks.data": {},
  "tasks.result": [
    "string"
  ]
}

Úspěšná odpověď

Vytváření úloh recenzí Google Shopping

OvěřováníRequired

DataForSEO

Vytváření úloh recenzí Google Shopping

Cenová reference