v0.2.0-beta

OpenAPI 3.1.0

Google Shopping Reviews-taken instellen

Felo API Support

MIT

Server

https://openapi.felo.ai

Clientbibliotheken

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Operaties

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

Google Shopping Reviews-taken instellen

Zet de reviews van één Google Shopping-product in de wachtrij en retourneert een taak-id. Identificeer het product met product_id plus gid of data_docid uit een productresultaat. Deze familie is volledig asynchroon: submit retourneert een taak-id in tasks[0].id en de fetch-tool retourneert het resultaat zodra het klaar is. Haal op met get_dataforseo_merchant_google_reviews_fetch.

Prijsreferentie

Afrekening: gerapporteerde responskosten.
Referentieschatting per verzoek: USD 0.012.
Referentiemultiplier voor klanten: 1.0. Niet opnieuw toepassen op een al afgerekend klantbedrag.

Alleen referentiemetadata, geen accountofferte en geen gegarandeerde prijs of bestedingslimiet. Resourcecredits zijn geen Felo-tegoed. De uiteindelijke kosten volgen de factureringsgegevens van Felo.

Body

verplicht

application/json

Type: array object[]
- Type: object
  gid
  Type: string
  verplicht
  
  Globale productidentificatie op Google Shopping. Verplicht veld. Voor optimale resultaten raden we aan gid samen met data_docid en product_id op te geven; u kunt deze waarde voor een bepaald product verkrijgen via een afzonderlijk verzoek aan het Google Shopping Products-endpoint. Voorbeeld: 4702526954592161872. Meer informatie over de parameter vindt u in deze handleiding van het Help Center.
  
  data_docid
  Type: string
  
  Unieke identificatie van het SERP-gegevenselement. Optioneel veld. Voor optimale resultaten raden we aan data_docid samen met product_id en gid op te geven; u kunt deze waarde voor een bepaald element verkrijgen via een afzonderlijk verzoek aan het Google Shopping Products-endpoint. Voorbeeld: 13071766526042404278
  
  depth
  Type: integer
  
  Parseerdiepte. Optioneel veld. Aantal beoordelingen in de SERP; we raden sterk aan de parseerdiepte in veelvouden van tien in te stellen, omdat ons systeem tien beoordelingen achter elkaar verwerkt; maximumwaarde: 8000. Standaardwaarde: 10. Uw account wordt gefactureerd per SERP met maximaal 10 resultaten; een diepte boven 10 kan extra kosten veroorzaken als de zoekmachine meer dan 10 resultaten retourneert; de kosten kunnen worden berekend op de pagina Pricing.
  
  language_code
  Type: string
  
  Taalcode van de zoekmachine. Verplicht veld als u language_name niet opgeeft. Als u dit veld gebruikt, hoeft u language_name niet op te geven. De lijst met beschikbare talen met hun language_code-parameters ontvangt u via een afzonderlijk verzoek aan https://api.dataforseo.com/v3/merchant/google/languages. Voorbeeld: en_GB
  
  language_name
  Type: string
  
  Volledige naam van de zoekmachinetaal. Verplicht veld als u language_code niet opgeeft. Als u dit veld gebruikt, hoeft u language_code niet op te geven. De lijst met beschikbare talen met hun language_name-parameters ontvangt u via een afzonderlijk verzoek aan https://api.dataforseo.com/v3/merchant/google/languages. Voorbeeld: English (United Kingdom)
  
  location_code
  Type: integer
  
  Locatiecode van de zoekmachine. Verplicht veld als u location_name of location_coordinate niet opgeeft. Als u dit veld gebruikt, hoeft u location_name of location_coordinate niet op te geven. De lijst met beschikbare locaties met hun location_code-parameters ontvangt u via een afzonderlijk verzoek aan https://api.dataforseo.com/v3/merchant/google/locations. Voorbeeld: 9045969
  
  location_coordinate
  Type: string
  
  GPS-coördinaten van een locatie. Verplicht veld als u location_name of location_code niet opgeeft. Als u dit veld gebruikt, hoeft u location_name of location_code niet op te geven. De parameter location_coordinate moet in het formaat ‘latitude,longitude,radius’ worden opgegeven. Het maximale aantal decimalen voor ‘latitude’ en ‘longitude’: 7. De minimumwaarde voor ‘radius’: 199.9. Voorbeeld: 53.476225,-2.243572,200
  
  location_name
  Type: string
  
  Volledige naam van de zoekmachinelocatie. Verplicht veld als u location_code of location_coordinate niet opgeeft. Als u dit veld gebruikt, hoeft u location_code of location_coordinate niet op te geven. De lijst met beschikbare locaties met hun location_name-parameters ontvangt u via een afzonderlijk verzoek aan https://api.dataforseo.com/v3/merchant/google/locations. Voorbeeld: HA1,England,United Kingdom
  
  pingback_url
  Type: string
  
  meldings-URL van een voltooide taak optioneel veld wanneer een taak is voltooid, melden we u dit via een GET-verzoek naar de URL die u hebt opgegeven. u kunt de tekenreeks ‘$id’ als $id-variabele en ‘$tag’ als url-gecodeerde $tag-variabele gebruiken. We stellen de benodigde waarden in voordat we het verzoek versturen. voorbeeld: http://your-server.com/pingscript?id=$id http://your-server.com/pingscript?id=$id&tag=$tag Let op: speciale tekens in pingback_url worden url-gecodeerd; d.w.z. het teken # wordt gecodeerd als %23. meer informatie vindt u in ons Help Center.
  
  postback_data
  Type: string
  
  postback_url-gegevenstype optioneel veld komt overeen met het gegevenstype dat naar uw server wordt verzonden mogelijke waarden: advanced
  
  postback_url
  Type: string
  
  URL voor het verzenden van taakresultaten optioneel veld zodra de taak is voltooid, sturen we een POST-verzoek met de resultaten gecomprimeerd in gzip-formaat naar de postback_url die u hebt opgegeven. u kunt de tekenreeks ‘$id’ als $id-variabele en ‘$tag’ als url-gecodeerde $tag-variabele gebruiken. We stellen de benodigde waarden in voordat we het verzoek versturen. voorbeeld: http://your-server.com/postbackscript?id=$id http://your-server.com/postbackscript?id=$id&tag=$tag Let op: speciale tekens in postback_url worden url-gecodeerd; d.w.z. het teken # wordt gecodeerd als %23. meer informatie vindt u in ons Help Center.
  
  priority
  Type: integer
  
  taakprioriteit optioneel veld kan de volgende waarden hebben: 1 – normale uitvoeringsprioriteit (standaard ingesteld) 2 – hoge uitvoeringsprioriteit Voor taken met hoge uitvoeringsprioriteit worden extra kosten in rekening gebracht. de kosten kunnen worden berekend op de pagina Pricing.
  
  product_id
  Type: string
  
  unieke productidentificatie op Google Shopping optioneel veld we raden aan product_id samen met data_docid en gid op te geven voor optimale resultaten; u kunt deze waarde voor een bepaald product verkrijgen via een apart verzoek aan het endpoint Google Shopping Products voorbeeld: 4485466949985702538 meer informatie over de parameter vindt u in deze gids van het Help Center
  
  se_domain
  Type: string
  
  domein van de zoekmachine optioneel veld we kiezen het relevante domein van de zoekmachine automatisch op basis van de locatie en taal die u opgeeft u kunt in dit veld echter een aangepast domein van de zoekmachine instellen voorbeeld: google.co.uk, google.com.au, google.de enz.
  
  tag
  Type: string
  
  Door gebruiker gedefinieerde taak-ID. Optioneel veld. De tekenslimiet is 255. Je kunt deze parameter gebruiken om de taak te identificeren en aan het resultaat te koppelen. De opgegeven waarde tag vind je in het data-object van de respons.
  
  Leeg object
  Leeg object

Responsen

200
Type: object

Geslaagde respons
cost
Type: number

Totale kosten van taken, USD

status_code
Type: integer

Algemene statuscode. De volledige lijst met responscodes vind je hier. Let op: we raden sterk aan een passend systeem te ontwerpen voor het afhandelen van gerelateerde uitzonderings- of foutsituaties.

status_message
Type: string

Algemeen informatief bericht. De volledige lijst met algemene informatieve berichten vind je hier.

tasks
Type: array string[]

Array met taken

tasks_count
Type: integer

het aantal taken in de tasksarray

tasks_error
Type: integer

Het aantal taken in de tasks-array dat met een fout is geretourneerd

tasks.cost
Type: number

Kosten van de taak, USD

tasks.data
Type: object

Bevat dezelfde parameters die je in het POST-verzoek hebt opgegeven

tasks.id
Type: string

unieke taakidentificatie in ons systeem in de indeling Universally unique identifier (UUID)

tasks.path
Type: array string[]

URL-pad

tasks.result
Type: array string[]

array met resultaten. In dit geval is de waarde null

tasks.result_count
Type: integer

Aantal elementen in de result-array

tasks.status_code
Type: integer

statuscode van de taak die door DataForSEO is gegenereerd; kan binnen het volgende bereik liggen: 10000-60000

tasks.status_message
Type: string

informatief bericht van de taak

tasks.time
Type: string

Uitvoeringstijd in seconden

time
Type: string

Uitvoeringstijd in seconden

version
Type: string

De huidige versie van de API
application/json
400

Het verzoek kon niet worden verwerkt. Controleer de verzoekparameters.
401

Een geldige Felo-API-sleutel is vereist.
402

Het verzoek kan niet doorgaan omdat niet aan een factureringsvoorwaarde is voldaan.
403

Het account mag deze bewerking niet uitvoeren.
429

Een verzoek- of bestedingslimiet is bereikt.
502

De dienst kon het verzoek niet voltooien.
503

De API of factureringsdienst is tijdelijk niet beschikbaar.
504

Er is een time-out opgetreden bij het verwerken van het verzoek.
default

Foutrespons; upstream-passthrough-responsen kunnen indelingen van de provider gebruiken

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 '[
  {},
  {}
]'

Schema tonen

{
  "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"
  ]
}

Geslaagde respons

Google Shopping Reviews-taken instellen

AuthenticatieRequired

DataForSEO

Google Shopping Reviews-taken instellen

Prijsreferentie