Felo API PlatformFelo API Platform
Todos os endpoints de DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Configurar tarefas de Google Shopping Reviews

Servidor:https://openapi.felo.ai
Bibliotecas Cliente

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.

Corpo
obrigatório
application/json
  • Tipo: array object[]
    • Tipo: object
      • gid
        Tipo: string
        obrigató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

      • data_docid
        Tipo: string

        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

      • depth
        Tipo: 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.

      • language_code
        Tipo: string

        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

      • language_name
        Tipo: string

        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)

      • location_code
        Tipo: integer

        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

      • location_coordinate
        Tipo: string

        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

      • location_name
        Tipo: string

        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

      • pingback_url
        Tipo: string

        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

      • postback_data
        Tipo: string

        tipo de dado de postback_url campo opcional corresponde ao tipo de dado que será enviado ao seu servidor valores possíveis: advanced

      • postback_url
        Tipo: string

        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

      • priority
        Tipo: 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.

      • product_id
        Tipo: string

        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

      • se_domain
        Tipo: string

        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.

      • tag
        Tipo: 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 vazio
      Objeto vazio
Respostas
  • 200
    Tipo: object

    Resposta bem-sucedida

    • cost
      Tipo: number

      custo total das tarefas, USD

    • status_code
      Tipo: integer

      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

    • status_message
      Tipo: string

      mensagem informativa geral você pode encontrar a lista completa das mensagens informativas gerais aqui

    • tasks
      Tipo: array string[]

      array de tarefas

    • tasks_count
      Tipo: integer

      o número de tarefas no array tasks

    • tasks_error
      Tipo: integer

      o número de tarefas no array de tarefas retornadas com erro

    • tasks.cost
      Tipo: number

      custo da tarefa, USD

    • tasks.data
      Tipo: object

      contém os mesmos parâmetros que você especificou na requisição POST

    • tasks.id
      Tipo: string

      identificador exclusivo da tarefa em nosso sistema no formato de identificador único universal (UUID)

    • tasks.path
      Tipo: array string[]

      caminho da URL

    • tasks.result
      Tipo: array string[]

      array de resultados neste caso, o valor será null

    • tasks.result_count
      Tipo: integer

      número de elementos no array de resultados

    • tasks.status_code
      Tipo: integer

      código de status da tarefa gerado pelo DataForSEO; pode estar dentro do seguinte intervalo: 10000-60000

    • tasks.status_message
      Tipo: string

      mensagem informativa da tarefa

    • tasks.time
      Tipo: string

      tempo de execução, segundos

    • time
      Tipo: string

      tempo de execução, segundos

    • version
      Tipo: string

      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
Request Example for 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 '[
  {},
  {}
]'
{
  "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"
  ]
}
Setting Google Shopping Reviews Tasks