Vytváření úloh Google My Business Info naživo
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Vytváření úloh Google My Business Info naživo
Jeden profil Google Business Profile: název, adresa, telefon, otevírací doba, hodnocení, kategorie a atributy, které Google zobrazuje v panelu. Odpověď je zabalena 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. Frontovaný protějšek je post_dataforseo_business_google_gmb_info_submit. Co majitel nedávno publikoval, zjistíte pomocí post_dataforseo_business_google_gmb_updates_submit, a názor zákazníků pomocí post_dataforseo_business_google_reviews_submit.
Referenční ceny
- Účtování: vykázaná cena odpovědi.
- Referenční odhad ceny požadavku: USD 0.0054.
- Referenční multiplikátor zákazníka: 1.0. Znovu jej neaplikujte na již zúčtovanou částku zákazníka.
Pouze referenční metadata — nikoli nabídka pro účet, garantovaná cena ani 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)[]
- keywordTyp: string
klíčové slovo
povinné pole
zadané klíčové slovo by mělo označovat název místní provozovny
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 vkeywordpoužít znak „%“, zadejte jej jako „%25“;toto pole lze také použít k předání následujících parametrů:
cid- jedinečné ID obchodního subjektu definované Googlem;place_id- identifikátor obchodního subjektu v Google Maps;příklad:
cid:194604053573767737place_id:GhIJQWDl0CIeQUARxks3icF8U8Avíce o identifikátorech
cidaplace_idv tomto článku nápovědyvíce o pravidlech a omezeních polí
keywordakeywordsv rozhraních DataForSEO najdete v tomto článku nápovědy - 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_codezískáte samostatným požadavkem nahttps://api.dataforseo.com/v3/business_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ů slanguage_namezískáte samostatným požadavkem nahttps://api.dataforseo.com/v3/business_data/google/languages
příklad:English - locationTyp: integer
_code kód lokality vyhledávače
povinné pole, pokud nezadátelocation_namenebolocation_coordinate
pokud toto pole použijete, nemusíte zadávatlocation_nameanilocation_coordinate
seznam dostupných lokalit slocation_codezískáte samostatným požadavkem nahttps://api.dataforseo.com/v3/business_data/google/locations
příklad:2840 - locationTyp: string
_coordinate GPS souřadnice lokality
povinné pole, pokud nezadátelocation_namenebolocation_code
pokud toto pole použijete, nemusíte zadávatlocation_nameanilocation_code
parametrlocation_coordinateje nutné zadat ve formátu "latitude,longitude,radius"
maximální počet desetinných míst pro "latitude" a "longitude": 7
minimální hodnota "radius": 199.9 (mm)
maximální hodnota "radius": 199999 (mm)
příklad:53.476225,-2.243572,200 - locationTyp: string
_name úplný název lokality vyhledávače
povinné pole, pokud nezadátelocation_codenebolocation_coordinate
pokud toto pole použijete, nemusíte zadávatlocation_codeanilocation_coordinate
seznam dostupných lokalit slocation_namezískáte samostatným požadavkem nahttps://api.dataforseo.com/v3/business_data/google/locations
příklad:London,England,United Kingdom - 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_BusinessDataGoogleMyBusinessInfoLiveResponseInfo200
- 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_BusinessDataGoogleMyBusinessInfoLiveTaskInfo
- 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: array (object | null)[] | null
pole výsledků
- checkTyp: string | null
_url přímá adresa URL na výsledky vyhledávače
můžete ji použít k ověření, že jsme poskytli přesné výsledky - datetimeTyp: string | null
datum a čas přijetí výsledku
ve formátu UTC: „yyyy-mm-dd hh-mm-ss +00:00”
příklad:2019-11-15 12:57:46 +00:00 - itemTyp: array (string | null)[] | null
_types typy prvků
typy výsledků vyhledávání nalezené v poliitems;
možné typy prvků:google_business_info - itemsTyp: array (object | null)[] | null
nalezené typy prvků
typy výsledků vyhledávání nalezené v poliitems;
možné typy prvků:google_business_info- additionalTyp: array string[] | null
_categories doplňkové kategorie podnikání
doplňkové kategorie Google My Business, které podrobněji popisují služby poskytované podnikatelským subjektem - addressTyp: string | null
adresa obchodního subjektu
- addressTyp: object | null · Response36Afe1097B20_AddressInfo
_info objekt obsahující složky adresy obchodního subjektu
- addressTyp: string | null
uliční adresa místní provozovny
- boroughTyp: string | null
správní jednotka nebo obvod, do kterého místní provozovna patří
- cityTyp: string | null
název města, kde se místní provozovna nachází
- countryTyp: string | null
_code kód země ISO místní provozovny
- regionTyp: string | null
oblast DMA, do které místní provozovna patří
- zipTyp: string | null
PSČ místní provozovny
- attributesTyp: object | null · Response36Afe1097B20_BusinessDataAttributesInfo
podrobnosti služeb ve formě kontrol hodnocených uživateli;
podrobnosti služeb obchodního subjektu zobrazené ve formě kontrol a založené na zpětné vazbě uživatelů acategorypodniku- availableTyp: object | null
_attributes dostupné atributy
udává atributy, které firma může nabízet- propertyTyp: array (string | null)[] | null
Name
- unavailableTyp: object | null
_attributes nedostupné atributy
udává atributy, které firma nemůže nabízet- propertyTyp: array (string | null)[] | null
Name
- bookTyp: string | null
_online _url adresa URL v tlačítku „book online” prvku
adresa URL vedoucí uživatele na stránku online rezervace nebo objednávky podnikatelského subjektu - categoryTyp: string | null
kategorie podnikání
obecná kategorie Google My Business, která nejlépe popisuje služby poskytované podnikatelským subjektem - categoryTyp: array string[] | null
_ids globální ID kategorií
univerzální ID kategorií, která se nemění podle vybrané země - cidTyp: string | null
- contactTyp: string | null
_url adresa URL preferované kontaktní stránky
- contributorTyp: string | null
_url adresa URL profilu Local Guides uživatele nebo subjektu, pokud je k dispozici
- descriptionTyp: string | null
popis prvku v SERP
popis obchodního subjektu, pro který se výsledky shromažďují - directoryTyp: object | null · Response36Afe1097B20_BusinessDirectoryInfo
položky adresáře
obsahuje informace o podnicích, které se nacházejí v cílové provozovně a mají stejnou adresu- itemsTyp: array (object | null)[] | null
nalezené typy prvků
typy výsledků vyhledávání nalezené v poliitems;
možné typy prvků:google_business_info- additionalTyp: array string[] | null
_categories doplňkové kategorie podnikání
doplňkové kategorie Google My Business, které podrobněji popisují služby poskytované podnikatelským subjektem - addressTyp: string | null
adresa obchodního subjektu
- addressTyp: object | null · Response36Afe1097B20_AddressInfo
_info objekt obsahující složky adresy obchodního subjektu
- addressTyp: string | null
uliční adresa místní provozovny
- boroughTyp: string | null
správní jednotka nebo obvod, do kterého místní provozovna patří
- cityTyp: string | null
název města, kde se místní provozovna nachází
- countryTyp: string | null
_code kód země ISO místní provozovny
- regionTyp: string | null
oblast DMA, do které místní provozovna patří
- zipTyp: string | null
PSČ místní provozovny
- categoryTyp: string | null
kategorie podnikání
obecná kategorie Google My Business, která nejlépe popisuje služby poskytované podnikatelským subjektem - categoryTyp: array string[] | null
_ids globální ID kategorií
univerzální ID kategorií, která se nemění podle vybrané země - cidTyp: string | null
- domainTyp: string | null
doména firmy
- featureTyp: string | null
_id - hotelTyp: string | null
_rating - isTyp: boolean | null
_claimed udává, zda je subjekt ověřen vlastníkem v Google Maps
- isTyp: boolean | null
_directory _item provozovna je součástí adresáře
udává, zda je provozovna součástí adresáře;
pokud jetrue, položka je součástí většího adresáře podniků se stejnou adresou (např. nákupního centra nebo kancelářské budovy);
poznámka: pokud je provozovna v adresáři nadřazenou položkou, hodnota budenull - latitudeTyp: number | null
souřadnice zeměpisné šířky místních provozoven v Mapách Google
příklad:"latitude": 51.584091 - localTyp: array string[] | null
_justifications místní zdůvodnění Google
úryvky textu, které „zdůvodňují”, proč se firma zobrazuje pro vyhledávací dotaz - longitudeTyp: number | null
souřadnice zeměpisné délky místní provozovny v Mapách Google
příklad:"longitude": -0.31365919999999997 - mainTyp: string | null
_image adresa URL hlavního obrázku v profilu Google My Business
- phoneTyp: string | null
telefonní číslo obchodního subjektu
- placeTyp: string | null
_id jedinečný identifikátor místa
place id místní provozovny uvedené v prvku
více o identifikátoru najdete v tomto článku nápovědy - priceTyp: string | null
_level cenová hladina podniku
může nabývat hodnot:inexpensive,moderate,expensive,very_expensive
pokud nejsou k dispozici informace o cenové hladině, bude hodnotanull - rankTyp: integer | null
_absolute absolutní pořadí mezi všemi prvky
- rankTyp: integer | null
_group pozice ve skupině prvků se shodnými hodnotami
type
pozice prvků s jinými hodnotamitypese vrank_groupvynechávají - ratingTyp: object | null · Response36Afe1097B20_RatingInfo
hodnocení prvku
míra popularity založená na recenzích, zobrazená v SERP- ratingTyp: integer | null
_max maximální hodnota pro rating_type
- ratingTyp: string | null
_type typ hodnocení zde najdete následující prvky: Max5, Percents, CustomMax
- valueTyp: number | null Formát: double
hodnota hodnocení
- votesTyp: integer | null Formát: int64
_count množství zpětné vazby
- ratingTyp: object | null
_distribution rozložení hodnocení obchodního subjektu objekt zobrazuje počet hodnocení od 1 do 5 hvězdiček podle recenzí uživatelů
- propertyTyp: integer | null Formát: Int64
Name
- snippetTyp: string | null
dodatečné informace o obchodním subjektu
- titleTyp: string | null
název adresáře
může nabývat následujících hodnot:At this place,Directory - totalTyp: string | null Formát: int64
_photos celkový počet obrázků v profilu Google My Business
- typeTyp: string | null
typ prvku
- urlTyp: string | null
URL pro zobrazení menu
- workTyp: object | null · Response36Afe1097B20_BusinessWorkHoursInfo
_hours otevírací doba
informace o pracovní době místní provozovny- workTyp: object | null · Response36Afe1097B20_WorkHours
_hours otevírací doba
informace o pracovní době místní provozovny- currentTyp: string | null
_status aktuální stav podniku
označuje, zda je podnik otevřený, nebo zavřený - timetableTyp: object | null
rozvrh pracovní doby
- propertyTyp: array (object | null)[] | null
Name pracovní doba v neděli
- closeTyp: object | null · Response36Afe1097B20_TimeInfo
zavírací doba
- hourTyp: integer | null
hodiny ve 24hodinovém formátu
- minuteTyp: integer | null
minuty
- openTyp: object | null · Response36Afe1097B20_TimeInfo
otevírací doba
- hourTyp: integer | null
hodiny ve 24hodinovém formátu
- minuteTyp: integer | null
minuty
- titleTyp: string | null
název prvku
doména online systému menu
- domainTyp: string | null
doména firmy
- featureTyp: string | null
_id - hotelTyp: number | null
_rating - isTyp: boolean | null
_claimed udává, zda je subjekt ověřen vlastníkem v Google Maps
- isTyp: boolean | null
_directory _item provozovna je součástí adresáře
udává, zda je provozovna součástí adresáře;
pokud jetrue, položka je součástí většího adresáře podniků se stejnou adresou (např. nákupního centra nebo kancelářské budovy);
poznámka: pokud je provozovna v adresáři nadřazenou položkou, hodnota budenull - latitudeTyp: number | null
souřadnice zeměpisné šířky místních provozoven v Mapách Google
příklad:"latitude": 51.584091 - localTyp: array (object | null)[] | null
_business _links dostupné interakce s podnikem
seznam možností interakce s podnikem přímo z výsledků vyhledávání- typeTyp: string | null
typ prvku
- logoTyp: string | null
URL loga zobrazeného v profilu Google My Business
- longitudeTyp: number | null
souřadnice zeměpisné délky místní provozovny v Mapách Google
příklad:"longitude": -0.31365919999999997 - mainTyp: string | null
_image adresa URL hlavního obrázku v profilu Google My Business
- originalTyp: string | null
_title původní název prvku
původní název nepřeložený Googlem - peopleTyp: array (object | null)[] | null
_also _search související obchodní subjekty
- cidTyp: string | null
- featureTyp: string | null
_id - ratingTyp: object | null · Response36Afe1097B20_RatingInfo
hodnocení prvku
míra popularity založená na recenzích, zobrazená v SERP- ratingTyp: integer | null
_max maximální hodnota pro rating_type
- ratingTyp: string | null
_type typ hodnocení zde najdete následující prvky: Max5, Percents, CustomMax
- valueTyp: number | null Formát: double
hodnota hodnocení
- votesTyp: integer | null Formát: int64
_count množství zpětné vazby
- titleTyp: string | null
název prvku v SERP
název obchodního subjektu, pro který se výsledky shromažďují
- phoneTyp: string | null
telefonní číslo obchodního subjektu
- placeTyp: string | null
_id jedinečný identifikátor místa
place id místní provozovny uvedené v prvku
více o identifikátoru najdete v tomto článku nápovědy - placeTyp: object | null
_topics klíčová slova zmíněná v recenzích zákazníků
obsahuje nejpopulárnější klíčová slova související s produkty/službami zmíněnými v recenzích zákazníků obchodního subjektu a počet recenzí, které každé klíčové slovo zmiňují
příklad:
"place_topics": {
"egg roll": 48,
"birthday": 33
}- propertyTyp: integer | null Formát: int64
Name Signed 64-bit integers (long type).
- popularTyp: object | null · Response36Afe1097B20_PopularTimes
_times oblíbené časy
informace o rušných hodinách obchodního subjektu- popularTyp: object | null
_times _by _days oblíbené hodiny
informace o vytížených hodinách místní provozovny v jednotlivých dnech týdne- propertyTyp: array (object | null)[] | null
Name pracovní doba v neděli
- popularTyp: integer | null
_index index popularity relativní časově vázaný index popularity měřený od 0 do 100; vyšší hodnota odpovídá vytíženější části dne
- timeTyp: object | null · Response36Afe1097B20_TimeInfo
hodiny ve 24hodinovém formátu
- hourTyp: integer | null
hodiny ve 24hodinovém formátu
- minuteTyp: integer | null
minuty
- positionTyp: string | null
zarovnání v SERP
- priceTyp: string | null
_level cenová hladina podniku
může nabývat hodnot:inexpensive,moderate,expensive,very_expensive
pokud nejsou k dispozici informace o cenové hladině, bude hodnotanull - questionsTyp: integer | null
_and _answers _count Integer numbers.
- rankTyp: integer | null
_absolute absolutní pořadí mezi všemi prvky
- rankTyp: integer | null
_group pozice ve skupině prvků se shodnými hodnotami
type
pozice prvků s odlišnými hodnotamitypese vrank_groupvynechávají - ratingTyp: object | null · Response36Afe1097B20_RatingInfo
hodnocení prvku
míra popularity založená na recenzích, zobrazená v SERP- ratingTyp: integer | null
_max maximální hodnota pro rating_type
- ratingTyp: string | null
_type typ hodnocení zde najdete následující prvky: Max5, Percents, CustomMax
- valueTyp: number | null Formát: double
hodnota hodnocení
- votesTyp: integer | null Formát: int64
_count množství zpětné vazby
- ratingTyp: object | null
_distribution rozložení hodnocení firmy
objekt zobrazuje počet hodnocení od 1 do 5 hvězdiček podle recenzí uživatelů- propertyTyp: integer | null Formát: Int64
Name
- servicesTyp: array (object | null)[] | null
seznam služeb nabízených podnikem
- categoryTyp: string | null
kategorie podnikání
obecná kategorie Google My Business, která nejlépe popisuje služby poskytované podnikatelským subjektem - priceTyp: object | null · Response36Afe1097B20_PriceInfo
- currencyTyp: string | null
měna uvedené ceny kód ISO měny použité na cenu
- currentTyp: number | null Formát: double
aktuální cena udává aktuální cenu produktu nebo služby uvedené ve výsledku
- displayedTyp: string | null
_price řetězec ceny ve výsledku surový řetězec ceny tak, jak je uveden ve výsledku
- isTyp: boolean | null
_price _range cena je uvedena jako rozsah udává, zda je cena uvedena jako rozsah
- maxTyp: number | null Formát: double
_value maximální cena maximální cena produktu nebo služby uvedená ve výsledku
- regularTyp: number | null Formát: double
běžná cena udává běžnou cenu produktu nebo služby bez uplatněných slev
- snippetTyp: string | null
doplňující informace o obchodním subjektu
- titleTyp: string | null
název prvku v SERP
název obchodního subjektu, pro který se výsledky shromažďují
- snippetTyp: string | null
doplňující informace o obchodním subjektu
- titleTyp: string | null
název prvku v SERP
název obchodního subjektu, pro který se výsledky shromažďují - totalTyp: integer | null Formát: int64
_photos celkový počet obrázků v profilu Google My Business
- typeTyp: string | null
typ prvku
- urlTyp: string | null
absolutní URL obchodního subjektu
- workTyp: object | null · Response36Afe1097B20_BusinessWorkHoursInfo
_time podrobnosti pracovní doby
informace o provozních hodinách obchodního subjektu- workTyp: object | null · Response36Afe1097B20_WorkHours
_hours otevírací doba
informace o pracovní době místní provozovny- currentTyp: string | null
_status aktuální stav podniku
označuje, zda je podnik otevřený, nebo zavřený - timetableTyp: object | null
rozvrh pracovní doby
- propertyTyp: array (object | null)[] | null
Name pracovní doba v neděli
- closeTyp: object | null · Response36Afe1097B20_TimeInfo
zavírací doba
- hourTyp: integer | null
hodiny ve 24hodinovém formátu
- minuteTyp: integer | null
minuty
- openTyp: object | null · Response36Afe1097B20_TimeInfo
otevírací doba
- hourTyp: integer | null
hodiny ve 24hodinovém formátu
- minuteTyp: integer | null
minuty
- itemsTyp: integer | null Formát: int64
_count typy prvků
počet prvků v poliitems - keywordTyp: string | null
- languageTyp: string | null
_code kód jazyka v poli POST
- locationTyp: integer | null
_code kód lokality v poli POST
- seTyp: string | null
_domain doména vyhledávače zadaná v poli POST
- 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/business_data/google/my_business_info/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en",
"location_name": "New York,New York,United States",
"keyword": "RustyBrick, Inc."
}
]'
{
"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": [
{
"keyword": null,
"se_domain": null,
"location_code": null,
"language_code": null,
"check_url": null,
"datetime": null,
"item_types": [
null
],
"items_count": null,
"items": [
{
"type": null,
"rank_group": null,
"rank_absolute": null,
"position": null,
"title": null,
"original_title": null,
"description": null,
"category": null,
"category_ids": [
"[Max Depth Exceeded]"
],
"additional_categories": [
"[Max Depth Exceeded]"
],
"cid": null,
"feature_id": null,
"address": null,
"address_info": "[Max Depth Exceeded]",
"place_id": null,
"phone": null,
"url": null,
"contact_url": null,
"contributor_url": null,
"book_online_url": null,
"domain": null,
"logo": null,
"main_image": null,
"total_photos": null,
"snippet": null,
"latitude": null,
"longitude": null,
"is_claimed": null,
"questions_and_answers_count": null,
"attributes": "[Max Depth Exceeded]",
"place_topics": null,
"rating": "[Max Depth Exceeded]",
"hotel_rating": null,
"price_level": null,
"rating_distribution": null,
"people_also_search": [
"[Max Depth Exceeded]"
],
"work_time": "[Max Depth Exceeded]",
"popular_times": "[Max Depth Exceeded]",
"local_business_links": [
"[Max Depth Exceeded]"
],
"is_directory_item": null,
"directory": "[Max Depth Exceeded]",
"services": [
"[Max Depth Exceeded]"
]
}
]
}
]
}
]
}