Configurar tarefas de Google My Business Info em tempo real
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Configurar tarefas de Google My Business Info em tempo real
Um Google Business Profile: nome, endereço, telefone, horários, avaliação, categoria e os atributos que o Google mostra no painel. Encapsulado no envelope do DataForSEO: dados em tasks[0].result, resultado em tasks[0].status_code — uma requisição rejeitada ainda retorna HTTP 200. O equivalente enfileirado é post_dataforseo_business_google_gmb_info_submit. Para o que o proprietário publicou recentemente, use post_dataforseo_business_google_gmb_updates_submit; para a opinião dos clientes, post_dataforseo_business_google_reviews_submit.
Referência de preços
- Medição: Custo da resposta reportado.
- Estimativa de referência por requisição: USD 0.0054.
- Multiplicador de referência do cliente: 1.0. Não o aplique novamente a um valor de cliente já liquidado.
Apenas metadados de referência, não uma cotação da conta, um preço garantido ou um limite de gastos. Créditos de recursos não são créditos Felo. As cobranças finais seguem os registros de cobrança da Felo.
- Tipo: array (object | null)[]
- keywordTipo: string
palavra-chave
campo obrigatório
a palavra-chave especificada deve indicar o nome do estabelecimento local
você pode especificar até 700 caracteres no campokeyword
todos os %## serão decodificados (o caractere ‘+’ será decodificado como espaço)
se precisar usar o caractere “%” no seukeyword, especifique-o como “%25”;este campo também pode ser usado para passar os seguintes parâmetros:
cid- um id exclusivo da entidade comercial, definido pelo Google;place_id- um identificador da entidade comercial no Google Maps;exemplo:
cid:194604053573767737place_id:GhIJQWDl0CIeQUARxks3icF8U8Asaiba mais sobre os identificadores
cideplace_idneste artigo da Central de Ajudasaiba mais sobre as regras e limitações dos campos
keywordekeywordsnas APIs do DataForSEO neste artigo da Central de Ajuda - languageTipo: string
_code código do idioma do mecanismo de busca
campo obrigatório se você não especificarlanguage_name
se você usar este campo, não precisa especificarlanguage_name
você pode obter a lista de idiomas disponíveis com seulanguage_codefazendo uma requisição separada parahttps://api.dataforseo.com/v3/business_data/google/languages
exemplo:en - languageTipo: string
_name nome completo do idioma do mecanismo de busca
campo obrigatório se você não especificarlanguage_code
se você usar este campo, não precisa especificarlanguage_code
você pode obter a lista de idiomas disponíveis comlanguage_namefazendo uma requisição separada parahttps://api.dataforseo.com/v3/business_data/google/languages
exemplo:English - locationTipo: integer
_code código de localização do mecanismo de pesquisa
campo obrigatório se você não especificarlocation_nameoulocation_coordinate
se você usar este campo, não precisará especificarlocation_nameoulocation_coordinate
você pode receber a lista de localizações disponíveis comlocation_codefazendo uma requisição separada parahttps://api.dataforseo.com/v3/business_data/google/locations
exemplo:2840 - locationTipo: string
_coordinate coordenadas GPS de um local
campo obrigatório se você não especificarlocation_name_orlocation_code
se você usar este campo, não precisa especificarlocation_nameoulocation_code
o parâmetrolocation_coordinatedeve ser especificado no formato "latitude,longitude,radius"
o número máximo de casas decimais para "latitude" e "longitude": 7
o valor mínimo para "radius": 199.9 (mm)
o valor máximo para "radius": 199999 (mm)
exemplo:53.476225,-2.243572,200 - locationTipo: string
_name nome completo do local do mecanismo de busca
campo obrigatório se você não especificarlocation_codeoulocation_coordinate
se você usar este campo, não precisa especificarlocation_codeoulocation_coordinate
você pode obter a lista de locais disponíveis comlocation_namefazendo uma requisição separada parahttps://api.dataforseo.com/v3/business_data/google/locations
exemplo:London,England,United Kingdom - tagTipo: string | null
identificador de tarefa definido pelo usuário
campo opcional
o limite de caracteres é 255
você pode usar este parâmetro para identificar a tarefa e associá-la ao resultado
você encontrará o valor detagespecificado no objetodatada resposta
- Tipo: object | null · Response36Afe1097B20_BusinessDataGoogleMyBusinessInfoLiveResponseInfo200
- Tipo: number | null Formato: doublecost
custo total das tarefas, USD
- Tipo: integer | nullstatus
_code código de status geral você pode encontrar a lista completa dos códigos de resposta aqui
- Tipo: string | nullstatus
_message mensagem informativa geral você pode encontrar a lista completa das mensagens informativas gerais aqui
- Tipo: array (object | null)[] | nulltasks
array de tarefas
- Tipo: object | null · Response36Afe1097B20_BusinessDataGoogleMyBusinessInfoLiveTaskInfo
- costTipo: number | null Formato: double
custo total das tarefas, USD
- dataTipo: object | null
contém os mesmos parâmetros que você especificou na requisição POST
- propertyTipo: object | null
Name
- idTipo: string | null
identificador da tarefa identificador exclusivo da tarefa em nosso sistema no formato UUID
- pathTipo: array (string | null)[] | null
caminho da URL
- resultTipo: array (object | null)[] | null
array de resultados
- checkTipo: string | null
_url URL direta para os resultados do mecanismo de busca
você pode usá-la para garantir que fornecemos resultados precisos - datetimeTipo: string | null
data e hora em que o resultado foi recebido
no formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
exemplo:2019-11-15 12:57:46 +00:00 - itemTipo: array (string | null)[] | null
_types tipos de itens
tipos de resultados de pesquisa encontrados no arrayitems;
tipos de itens possíveis:google_business_info - itemsTipo: array (object | null)[] | null
tipos de itens encontrados
tipos de resultados de pesquisa encontrados no arrayitems;
tipos de itens possíveis:google_business_info- additionalTipo: array string[] | null
_categories categorias de negócio adicionais
categorias adicionais do Google My Business que descrevem com mais detalhes os serviços prestados pela entidade empresarial - addressTipo: string | null
endereço da entidade comercial
- addressTipo: object | null · Response36Afe1097B20_AddressInfo
_info objeto que contém os componentes de endereço da entidade comercial
- addressTipo: string | null
endereço do estabelecimento local
- boroughTipo: string | null
unidade administrativa ou distrito ao qual o estabelecimento local pertence
- cityTipo: string | null
nome da cidade onde o estabelecimento local está localizado
- countryTipo: string | null
_code código ISO do país do estabelecimento local
- regionTipo: string | null
região DMA à qual o estabelecimento local pertence
- zipTipo: string | null
código postal do estabelecimento local
- attributesTipo: object | null · Response36Afe1097B20_BusinessDataAttributesInfo
detalhes do serviço em forma de verificações avaliadas por usuários;
detalhes do serviço de uma entidade comercial exibidos em forma de verificações e baseados no feedback dos usuários e nacategorydo negócio- availableTipo: object | null
_attributes atributos disponíveis
indica os atributos que uma entidade comercial pode oferecer- propertyTipo: array (string | null)[] | null
Name
- unavailableTipo: object | null
_attributes atributos indisponíveis
indica os atributos que uma entidade comercial não pode oferecer- propertyTipo: array (string | null)[] | null
Name
- bookTipo: string | null
_online _url URL no botão 'reservar online' do elemento
URL que direciona os usuários para a página de reserva ou pedido online da entidade empresarial - categoryTipo: string | null
categoria de negócio
categoria geral do Google My Business que melhor descreve os serviços prestados pela entidade empresarial - categoryTipo: array string[] | null
_ids IDs globais de categoria
IDs universais de categoria que não mudam com base no país selecionado - cidTipo: string | null
- contactTipo: string | null
_url URL da página de contato preferida
- contributorTipo: string | null
_url URL do perfil do Local Guides do usuário ou da entidade, se disponível
- descriptionTipo: string | null
descrição do elemento na SERP
a descrição da entidade comercial para a qual os resultados são coletados - directoryTipo: object | null · Response36Afe1097B20_BusinessDirectoryInfo
itens do diretório
inclui informações sobre empresas localizadas dentro do estabelecimento comercial de destino e que têm o mesmo endereço- itemsTipo: array (object | null)[] | null
tipos de itens encontrados
tipos de resultados de pesquisa encontrados no arrayitems;
tipos de itens possíveis:google_business_info- additionalTipo: array string[] | null
_categories categorias de negócio adicionais
categorias adicionais do Google My Business que descrevem com mais detalhes os serviços prestados pela entidade empresarial - addressTipo: string | null
endereço da entidade comercial
- addressTipo: object | null · Response36Afe1097B20_AddressInfo
_info objeto que contém os componentes de endereço da entidade comercial
- addressTipo: string | null
endereço do estabelecimento local
- boroughTipo: string | null
unidade administrativa ou distrito ao qual o estabelecimento local pertence
- cityTipo: string | null
nome da cidade onde o estabelecimento local está localizado
- countryTipo: string | null
_code código ISO do país do estabelecimento local
- regionTipo: string | null
região DMA à qual o estabelecimento local pertence
- zipTipo: string | null
código postal do estabelecimento local
- categoryTipo: string | null
categoria de negócio
categoria geral do Google My Business que melhor descreve os serviços prestados pela entidade empresarial - categoryTipo: array string[] | null
_ids IDs globais de categoria
IDs universais de categoria que não mudam com base no país selecionado - cidTipo: string | null
- domainTipo: string | null
domínio da entidade comercial
- featureTipo: string | null
_id - hotelTipo: string | null
_rating - isTipo: boolean | null
_claimed mostra se a entidade foi verificada pelo proprietário no Google Maps
- isTipo: boolean | null
_directory _item o estabelecimento comercial faz parte do diretório
indica se o estabelecimento comercial faz parte do diretório;
setrue, o item faz parte de um diretório maior de empresas com o mesmo endereço (por exemplo, um shopping ou um centro comercial);
observação: se o estabelecimento comercial for um item pai no diretório, o valor seránull - latitudeTipo: number | null
coordenada de latitude dos estabelecimentos locais no google maps
exemplo:"latitude": 51.584091 - localTipo: array string[] | null
_justifications justificativas locais do Google
trechos de texto que “justificam” por que a empresa aparece para a consulta de pesquisa - longitudeTipo: number | null
coordenada de longitude do estabelecimento local no google maps
exemplo:"longitude": -0.31365919999999997 - mainTipo: string | null
_image URL da imagem principal apresentada no perfil do Google My Business
- phoneTipo: string | null
telefone da entidade comercial
- placeTipo: string | null
_id identificador exclusivo do local
place id do estabelecimento local apresentado no elemento
saiba mais sobre o identificador neste artigo da central de ajuda - priceTipo: string | null
_level nível de preço do estabelecimento
pode assumir os valores:inexpensive,moderate,expensive,very_expensive
se não houver informações de nível de preço, o valor seránull - rankTipo: integer | null
_absolute ranking absoluto entre todos os elementos
- rankTipo: integer | null
_group posição dentro de um grupo de elementos com valores de
typeidênticos
as posições dos elementos com valores detypediferentes são omitidas derank_group - ratingTipo: object | null · Response36Afe1097B20_RatingInfo
a avaliação do elemento
a taxa de popularidade com base nas avaliações e exibida na SERP- ratingTipo: integer | null
_max o valor máximo para um rating_type
- ratingTipo: string | null
_type o tipo de avaliação aqui você pode encontrar os seguintes elementos: Max5, Percents, CustomMax
- valueTipo: number | null Formato: double
o valor da avaliação
- votesTipo: integer | null Formato: int64
_count a quantidade de feedback
- ratingTipo: object | null
_distribution a distribuição das avaliações da entidade comercial o objeto exibe o número de avaliações de 1 a 5 estrelas, conforme avaliado pelos usuários
- propertyTipo: integer | null Formato: Int64
Name
- snippetTipo: string | null
informações adicionais sobre a entidade comercial
- titleTipo: string | null
título do diretório
pode assumir os seguintes valores:At this place,Directory - totalTipo: string | null Formato: int64
_photos número total de imagens apresentadas no perfil do Google My Business
- typeTipo: string | null
tipo de elemento
- urlTipo: string | null
URL para visualizar o cardápio
- workTipo: object | null · Response36Afe1097B20_BusinessWorkHoursInfo
_hours horário de funcionamento
informações sobre o horário de trabalho do estabelecimento local- workTipo: object | null · Response36Afe1097B20_WorkHours
_hours horário de funcionamento
informações sobre o horário de trabalho do estabelecimento local- currentTipo: string | null
_status status atual do estabelecimento
indica se o estabelecimento está aberto ou fechado - timetableTipo: object | null
tabela de horários de funcionamento
- propertyTipo: array (object | null)[] | null
Name horário de funcionamento aos domingos
- closeTipo: object | null · Response36Afe1097B20_TimeInfo
horário de fechamento
- hourTipo: integer | null
horas no formato de 24 horas
- minuteTipo: integer | null
minutos
- openTipo: object | null · Response36Afe1097B20_TimeInfo
horário de abertura
- hourTipo: integer | null
horas no formato de 24 horas
- minuteTipo: integer | null
minutos
- titleTipo: string | null
título do elemento
domínio do sistema de menu online
- domainTipo: string | null
domínio da entidade comercial
- featureTipo: string | null
_id - hotelTipo: number | null
_rating - isTipo: boolean | null
_claimed mostra se a entidade foi verificada pelo proprietário no Google Maps
- isTipo: boolean | null
_directory _item o estabelecimento comercial faz parte do diretório
indica se o estabelecimento comercial faz parte do diretório;
setrue, o item faz parte de um diretório maior de empresas com o mesmo endereço (por exemplo, um shopping ou um centro comercial);
observação: se o estabelecimento comercial for um item pai no diretório, o valor seránull - latitudeTipo: number | null
coordenada de latitude dos estabelecimentos locais no google maps
exemplo:"latitude": 51.584091 - localTipo: array (object | null)[] | null
_business _links interações disponíveis com a empresa
lista de opções para interagir com a empresa diretamente nos resultados de pesquisa- typeTipo: string | null
tipo de elemento
- logoTipo: string | null
URL do logotipo exibido no perfil do Google My Business
- longitudeTipo: number | null
coordenada de longitude do estabelecimento local no google maps
exemplo:"longitude": -0.31365919999999997 - mainTipo: string | null
_image URL da imagem principal apresentada no perfil do Google My Business
- originalTipo: string | null
_title título original do elemento
título original não traduzido pelo Google - peopleTipo: array (object | null)[] | null
_also _search entidades comerciais relacionadas
- cidTipo: string | null
- featureTipo: string | null
_id - ratingTipo: object | null · Response36Afe1097B20_RatingInfo
a avaliação do elemento
a taxa de popularidade com base nas avaliações e exibida na SERP- ratingTipo: integer | null
_max o valor máximo para um rating_type
- ratingTipo: string | null
_type o tipo de avaliação aqui você pode encontrar os seguintes elementos: Max5, Percents, CustomMax
- valueTipo: number | null Formato: double
o valor da avaliação
- votesTipo: integer | null Formato: int64
_count a quantidade de feedback
- titleTipo: string | null
título do elemento na SERP
o nome da entidade comercial para a qual os resultados são coletados
- phoneTipo: string | null
telefone da entidade comercial
- placeTipo: string | null
_id identificador exclusivo do local
place id do estabelecimento local apresentado no elemento
saiba mais sobre o identificador neste artigo da central de ajuda - placeTipo: object | null
_topics palavras-chave mencionadas nas avaliações de clientes
contém as palavras-chave mais populares relacionadas a produtos/serviços mencionados nas avaliações de clientes de uma entidade comercial e o número de avaliações que mencionam cada palavra-chave
exemplo:
"place_topics": {
"egg roll": 48,
"birthday": 33
}- propertyTipo: integer | null Formato: int64
Name Signed 64-bit integers (long type).
- popularTipo: object | null · Response36Afe1097B20_PopularTimes
_times horários de maior movimento
informações relacionadas aos horários de pico da entidade comercial- popularTipo: object | null
_times _by _days horários de pico
informações sobre os horários de maior movimento do estabelecimento local em cada dia da semana- propertyTipo: array (object | null)[] | null
Name horário de funcionamento aos domingos
- popularTipo: integer | null
_index índice de popularidade índice de popularidade relativo e limitado no tempo, medido de 0 a 100; um valor mais alto corresponde a um horário do dia com mais movimento
- timeTipo: object | null · Response36Afe1097B20_TimeInfo
horas no formato de 24 horas
- hourTipo: integer | null
horas no formato de 24 horas
- minuteTipo: integer | null
minutos
- positionTipo: string | null
o alinhamento na SERP
- priceTipo: string | null
_level nível de preço do estabelecimento
pode assumir os valores:inexpensive,moderate,expensive,very_expensive
se não houver informações de nível de preço, o valor seránull - questionsTipo: integer | null
_and _answers _count Integer numbers.
- rankTipo: integer | null
_absolute ranking absoluto entre todos os elementos
- rankTipo: integer | null
_group posição dentro de um grupo de elementos com valores de
typeidênticos
as posições dos elementos com valores detypediferentes são omitidas derank_group - ratingTipo: object | null · Response36Afe1097B20_RatingInfo
a avaliação do elemento
a taxa de popularidade com base nas avaliações e exibida na SERP- ratingTipo: integer | null
_max o valor máximo para um rating_type
- ratingTipo: string | null
_type o tipo de avaliação aqui você pode encontrar os seguintes elementos: Max5, Percents, CustomMax
- valueTipo: number | null Formato: double
o valor da avaliação
- votesTipo: integer | null Formato: int64
_count a quantidade de feedback
- ratingTipo: object | null
_distribution a distribuição de avaliações da entidade comercial
o objeto exibe o número de avaliações de 1 a 5 estrelas, conforme avaliado pelos usuários- propertyTipo: integer | null Formato: Int64
Name
- servicesTipo: array (object | null)[] | null
lista de serviços oferecidos pelo negócio
- categoryTipo: string | null
categoria de negócio
categoria geral do Google My Business que melhor descreve os serviços prestados pela entidade empresarial - priceTipo: object | null · Response36Afe1097B20_PriceInfo
- currencyTipo: string | null
moeda do preço listado código ISO da moeda aplicada ao preço
- currentTipo: number | null Formato: double
preço atual indica o preço atual do produto ou serviço em destaque no resultado
- displayedTipo: string | null
_price string de preço no resultado string de preço bruta conforme fornecida no resultado
- isTipo: boolean | null
_price _range o preço é fornecido como um intervalo indica se um preço é fornecido como um intervalo
- maxTipo: number | null Formato: double
_value o preço máximo o preço máximo do produto ou serviço conforme indicado no resultado
- regularTipo: number | null Formato: double
preço normal indica o preço normal do produto ou serviço sem descontos aplicados
- snippetTipo: string | null
informações adicionais sobre a entidade comercial
- titleTipo: string | null
título do elemento na SERP
o nome da entidade comercial para a qual os resultados são coletados
- snippetTipo: string | null
informações adicionais sobre a entidade comercial
- titleTipo: string | null
título do elemento na SERP
o nome da entidade comercial para a qual os resultados são coletados - totalTipo: integer | null Formato: int64
_photos número total de imagens apresentadas no perfil do Google My Business
- typeTipo: string | null
tipo de elemento
- urlTipo: string | null
url absoluta da entidade comercial
- workTipo: object | null · Response36Afe1097B20_BusinessWorkHoursInfo
_time detalhes do horário de funcionamento
informações relacionadas ao horário de funcionamento da entidade comercial- workTipo: object | null · Response36Afe1097B20_WorkHours
_hours horário de funcionamento
informações sobre o horário de trabalho do estabelecimento local- currentTipo: string | null
_status status atual do estabelecimento
indica se o estabelecimento está aberto ou fechado - timetableTipo: object | null
tabela de horários de funcionamento
- propertyTipo: array (object | null)[] | null
Name horário de funcionamento aos domingos
- closeTipo: object | null · Response36Afe1097B20_TimeInfo
horário de fechamento
- hourTipo: integer | null
horas no formato de 24 horas
- minuteTipo: integer | null
minutos
- openTipo: object | null · Response36Afe1097B20_TimeInfo
horário de abertura
- hourTipo: integer | null
horas no formato de 24 horas
- minuteTipo: integer | null
minutos
- itemsTipo: integer | null Formato: int64
_count tipos de itens
o número de itens no arrayitems - keywordTipo: string | null
palavra-chave recebida em um array POST
a palavra-chave é retornada com %## decodificado (o caractere '+' será decodificado como um espaço)
este campo conterá o parâmetrocidse você o especificou no campokeywordao definir uma tarefa;
exemplo:cid:2946633002421908862
saiba mais sobre o parâmetro neste artigo da central de ajuda - languageTipo: string | null
_code código de idioma em um array POST
- locationTipo: integer | null
_code código de localização em um array POST
- seTipo: string | null
_domain domínio do mecanismo de busca conforme especificado em um array POST
- resultTipo: integer | null Formato: int64
_count número de elementos no array de resultados
- statusTipo: integer | null
_code código de status da tarefa gerado pelo DataForSEO; pode estar no seguinte intervalo: 10000-60000 você pode encontrar a lista completa dos códigos de resposta aqui
- statusTipo: string | null
_message mensagem informativa da tarefa você pode encontrar a lista completa das mensagens informativas gerais aqui
- timeTipo: string | null
tempo de execução, segundos
- Tipo: integer | null Formato: int64tasks
_count o número de tarefas no array de tarefas
- Tipo: integer | null Formato: int64tasks
_error o número de tarefas no array de tarefas retornadas com erro
- Tipo: string | nulltime
tempo total de execução, em segundos
- Tipo: string | nullversion
a versão atual da API
application/json - 400
Não foi possível processar a requisição. Verifique os parâmetros da requisição.
- 401
É necessária uma chave de API da Felo válida.
- 402
A requisição não pode prosseguir porque um requisito de cobrança não foi atendido.
- 403
A conta não tem permissão para realizar esta operação.
- 429
Um limite de requisições ou de gastos foi atingido.
- 502
O serviço não pôde concluir a requisição.
- 503
A API ou o serviço de cobrança está temporariamente indisponível.
- 504
O serviço atingiu o tempo limite ao processar a requisição.
- default
Resposta de erro; respostas repassadas do upstream podem usar formatos do provedor
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]"
]
}
]
}
]
}
]
}