Configurar tarefas de Google Shopping Reviews
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Configurar tarefas de Google Shopping Reviews
Enfileira as avaliações de um produto do Google Shopping, retornando um id de tarefa. Identifique o produto com product_id mais gid ou data_docid de um resultado de produtos. Esta família é assíncrona de ponta a ponta: o envio retorna um id de tarefa em tasks[0].id, e a ferramenta de busca retorna o resultado quando ele estiver pronto. Recupere com get_dataforseo_merchant_google_reviews_fetch.
Referência de preços
- Medição: Custo da resposta reportado.
- Estimativa de referência por requisição: USD 0.012.
- 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[]
- Tipo: object
- gidTipo: stringobrigatório
identificador global do produto no Google Shopping campo obrigatório recomendamos especificar gid junto com data_docid e product_id para obter resultados ideais; você pode obter este valor para um determinado produto fazendo uma requisição separada para o endpoint Google Shopping Products exemplo: 4702526954592161872 saiba mais sobre o parâmetro neste guia da Central de Ajuda
- dataTipo: string
_docid identificador exclusivo do elemento de dados da SERP campo opcional recomendamos especificar data_docid junto com product_id e gid para obter resultados ideais; você pode obter este valor para um determinado elemento fazendo uma requisição separada para o endpoint Google Shopping Products exemplo: 13071766526042404278
- depthTipo: integer
profundidade de análise campo opcional número de avaliações na SERP; recomendamos vivamente definir a profundidade de análise em múltiplos de dez, porque nosso sistema processa dez avaliações seguidas; valor máximo: 8000 valor padrão: 10 Sua conta será cobrada por cada SERP que contenha até 10 resultados; Definir uma profundidade acima de 10 pode gerar cobranças adicionais se o mecanismo de busca retornar mais de 10 resultados; O custo pode ser calculado na página de preços.
- languageTipo: string
_code código do idioma do mecanismo de busca campo obrigatório se você não especificar language_name se você usar este campo, não precisa especificar language_name você pode obter a lista de idiomas disponíveis com seus parâmetros language_code fazendo uma requisição separada para https://api.dataforseo.com/v3/merchant/google/languages exemplo: en_GB
- languageTipo: string
_name nome completo do idioma do mecanismo de busca campo obrigatório se você não especificar language_code se você usar este campo, não precisa especificar language_code você pode obter a lista de idiomas disponíveis com seus parâmetros language_name fazendo uma requisição separada para https://api.dataforseo.com/v3/merchant/google/languages exemplo: English (United Kingdom)
- locationTipo: integer
_code código do local do mecanismo de busca campo obrigatório se você não especificar location_name ou location_coordinate se você usar este campo, não precisa especificar location_name ou location_coordinate você pode obter a lista de locais disponíveis com seus parâmetros location_code fazendo uma requisição separada para https://api.dataforseo.com/v3/merchant/google/locations exemplo: 9045969
- locationTipo: string
_coordinate coordenadas GPS de um local campo obrigatório se você não especificar location_name ou location_code se você usar este campo, não precisa especificar location_name ou location_code o parâmetro location_coordinate deve ser especificado no formato “latitude,longitude,radius” o número máximo de dígitos decimais para “latitude” e “longitude”: 7 o valor mínimo para “radius”: 199.9 exemplo: 53.476225,-2.243572,200
- locationTipo: string
_name nome completo do local do mecanismo de busca campo obrigatório se você não especificar location_code ou location_coordinate se você usar este campo, não precisa especificar location_code ou location_coordinate você pode obter a lista de locais disponíveis com seus parâmetros location_name fazendo uma requisição separada para https://api.dataforseo.com/v3/merchant/google/locations exemplo: HA1,England,United Kingdom
- pingbackTipo: string
_url URL de notificação de uma tarefa concluída campo opcional quando uma tarefa é concluída, notificaremos você por meio de uma requisição GET enviada para a URL que você especificou você pode usar a string ‘$id’ como variável $id e ‘$tag’ como variável $tag codificada para URL. Definiremos os valores necessários antes de enviar a requisição. exemplo: http://your-server.com/pingscript?id=$id http://your-server.com/pingscript?id=$id&tag=$tag Observação: caracteres especiais em pingback_url serão codificados para URL, por exemplo, o caractere # será codificado como %23 saiba mais na nossa Central de Ajuda
- postbackTipo: string
_data tipo de dado de postback_url campo opcional corresponde ao tipo de dado que será enviado ao seu servidor valores possíveis: advanced
- postbackTipo: string
_url URL para envio dos resultados da tarefa campo opcional quando a tarefa for concluída, enviaremos uma requisição POST com os resultados compactados no formato gzip para o postback_url que você especificou você pode usar a string ‘$id’ como variável $id e ‘$tag’ como variável $tag codificada para URL. Definiremos os valores necessários antes de enviar a requisição. exemplo: http://your-server.com/postbackscript?id=$id http://your-server.com/postbackscript?id=$id&tag=$tag Observação: caracteres especiais em postback_url serão codificados para URL, por exemplo, o caractere # será codificado como %23 saiba mais na nossa Central de Ajuda
- priorityTipo: integer
prioridade da tarefa campo opcional pode assumir os seguintes valores: 1 – prioridade de execução normal (definida por padrão) 2 – prioridade de execução alta Você será cobrado adicionalmente pelas tarefas com prioridade de execução alta. o custo pode ser calculado na página Pricing.
- productTipo: string
_id identificador exclusivo do produto no Google Shopping campo opcional recomendamos especificar product_id junto com data_docid e gid para obter resultados ideais; você pode obter esse valor para um determinado produto fazendo uma requisição separada ao endpoint Google Shopping Products exemplo: 4485466949985702538 saiba mais sobre o parâmetro neste guia da central de ajuda
- seTipo: string
_domain domínio do mecanismo de busca campo opcional escolhemos o domínio do mecanismo de busca relevante automaticamente de acordo com o local e o idioma que você especificar no entanto, você pode definir um domínio de mecanismo de busca personalizado neste campo exemplo: google.co.uk, google.com.au, google.de, etc.
- tagTipo: string
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 tag especificado no objeto data da resposta
Objeto vazioObjeto vazio
- Tipo: object200
Resposta bem-sucedida
- Tipo: numbercost
custo total das tarefas, USD
- Tipo: integerstatus
_code código de status geral você pode encontrar a lista completa dos códigos de resposta aqui Observação: recomendamos fortemente projetar um sistema necessário para lidar com condições excepcionais ou de erro relacionadas
- Tipo: stringstatus
_message mensagem informativa geral você pode encontrar a lista completa das mensagens informativas gerais aqui
- Tipo: array string[]tasks
array de tarefas
- Tipo: integertasks
_count o número de tarefas no array tasks
- Tipo: integertasks
_error o número de tarefas no array de tarefas retornadas com erro
- Tipo: numbertasks
.cost custo da tarefa, USD
- Tipo: objecttasks
.data contém os mesmos parâmetros que você especificou na requisição POST
- Tipo: stringtasks
.id identificador exclusivo da tarefa em nosso sistema no formato de identificador único universal (UUID)
- Tipo: array string[]tasks
.path caminho da URL
- Tipo: array string[]tasks
.result array de resultados neste caso, o valor será null
- Tipo: integertasks
.result _count número de elementos no array de resultados
- Tipo: integertasks
.status _code código de status da tarefa gerado pelo DataForSEO; pode estar dentro do seguinte intervalo: 10000-60000
- Tipo: stringtasks
.status _message mensagem informativa da tarefa
- Tipo: stringtasks
.time tempo de execução, segundos
- Tipo: stringtime
tempo de execução, segundos
- Tipo: stringversion
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/merchant/google/reviews/task_post \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{},
{}
]'
{
"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"
]
}