Google Shopping Review-Aufgaben einstellen
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Google Shopping Review-Aufgaben einstellen
Stellt die Reviews eines Google Shopping-Produkts in die Warteschlange und gibt eine Aufgaben-id zurück. Identifizieren Sie das Produkt mit product_id plus gid oder data_docid aus einem Produktergebnis. Diese Familie ist durchgängig asynchron: submit gibt eine Aufgaben-id in tasks[0].id zurück, und das Fetch-Tool liefert das Ergebnis, sobald es bereit ist. Rufen Sie mit get_dataforseo_merchant_google_reviews_fetch ab.
Preisreferenz
- Abrechnung: Gemeldete Antwortkosten.
- Referenzschätzung pro Anfrage: USD 0.012.
- Referenz-Kundenmultiplikator: 1.0. Nicht erneut auf bereits abgerechnete Kundenbeträge anwenden.
Nur Referenzmetadaten, kein Kontenangebot und keine garantierte Preis- oder Ausgabenobergrenze. Ressourcen-Credits sind keine Felo-Credits. Endgültige Abrechnungen richten sich nach den Felo-Abrechnungsbelegen.
- Typ: array object[]
- Typ: object
- gidTyp: stringerforderlich
Globale Produktkennung bei Google Shopping. Pflichtfeld. Für optimale Ergebnisse empfehlen wir, gid zusammen mit data_docid und product_id anzugeben; diesen Wert für ein bestimmtes Produkt erhalten Sie durch eine separate Anfrage an den Google Shopping Products-Endpunkt. Beispiel: 4702526954592161872. Weitere Informationen zum Parameter finden Sie in dieser Help-Center-Anleitung.
- dataTyp: string
_docid Eindeutige Kennung des SERP-Datenelements. Optionales Feld. Für optimale Ergebnisse empfehlen wir, data_docid zusammen mit product_id und gid anzugeben; diesen Wert für ein bestimmtes Element erhalten Sie durch eine separate Anfrage an den Google Shopping Products-Endpunkt. Beispiel: 13071766526042404278
- depthTyp: integer
Parsing-Tiefe. Optionales Feld. Anzahl der Bewertungen in der SERP; wir empfehlen dringend, die Parsing-Tiefe in Vielfachen von zehn festzulegen, da unser System zehn Bewertungen am Stück verarbeitet; Maximalwert: 8000. Standardwert: 10. Ihr Konto wird für jede SERP abgerechnet, die bis zu 10 Ergebnisse enthält; eine Tiefe über 10 kann zu zusätzlichen Kosten führen, wenn die Suchmaschine mehr als 10 Ergebnisse zurückgibt; die Kosten lassen sich auf der Seite Pricing berechnen.
- languageTyp: string
_code Sprachcode der Suchmaschine. Pflichtfeld, wenn Sie language_name nicht angeben. Wenn Sie dieses Feld verwenden, müssen Sie language_name nicht angeben. Die Liste der verfügbaren Sprachen mit ihren language_code-Parametern erhalten Sie durch eine separate Anfrage an https://api.dataforseo.com/v3/merchant/google/languages. Beispiel: en_GB
- languageTyp: string
_name Vollständiger Name der Suchmaschinensprache. Pflichtfeld, wenn Sie language_code nicht angeben. Wenn Sie dieses Feld verwenden, müssen Sie language_code nicht angeben. Die Liste der verfügbaren Sprachen mit ihren language_name-Parametern erhalten Sie durch eine separate Anfrage an https://api.dataforseo.com/v3/merchant/google/languages. Beispiel: English (United Kingdom)
- locationTyp: integer
_code Standortcode der Suchmaschine. Pflichtfeld, wenn Sie location_name oder location_coordinate nicht angeben. Wenn Sie dieses Feld verwenden, müssen Sie location_name oder location_coordinate nicht angeben. Die Liste der verfügbaren Standorte mit ihren location_code-Parametern erhalten Sie durch eine separate Anfrage an https://api.dataforseo.com/v3/merchant/google/locations. Beispiel: 9045969
- locationTyp: string
_coordinate GPS-Koordinaten eines Standorts. Pflichtfeld, wenn Sie location_name oder location_code nicht angeben. Wenn Sie dieses Feld verwenden, müssen Sie location_name oder location_code nicht angeben. Der Parameter location_coordinate muss im Format „latitude,longitude,radius“ angegeben werden. Die maximale Anzahl der Nachkommastellen für „latitude“ und „longitude“: 7. Der Mindestwert für „radius“: 199.9. Beispiel: 53.476225,-2.243572,200
- locationTyp: string
_name Vollständiger Name des Suchmaschinenstandorts. Pflichtfeld, wenn Sie location_code oder location_coordinate nicht angeben. Wenn Sie dieses Feld verwenden, müssen Sie location_code oder location_coordinate nicht angeben. Die Liste der verfügbaren Standorte mit ihren location_name-Parametern erhalten Sie durch eine separate Anfrage an https://api.dataforseo.com/v3/merchant/google/locations. Beispiel: HA1,England,United Kingdom
- pingbackTyp: string
_url Benachrichtigungs-URL für eine abgeschlossene Aufgabe Optionales Feld Wenn eine Aufgabe abgeschlossen ist, benachrichtigen wir Sie per GET-Anfrage an die von Ihnen angegebene URL. Sie können die Zeichenfolge ‘$id’ als $id-Variable und ‘$tag’ als urlencodierte $tag-Variable verwenden. Wir setzen die erforderlichen Werte vor dem Senden der Anfrage. Beispiel: http://your-server.com/pingscript?id=$id http://your-server.com/pingscript?id=$id&tag=$tag Hinweis: Sonderzeichen in pingback_url werden urlencodiert; u. a. wird das Zeichen # in %23 kodiert. Weitere Informationen finden Sie in unserem Help Center.
- postbackTyp: string
_data postback_url-Datentyp Optionales Feld Entspricht dem Datentyp, der an Ihren Server gesendet wird Mögliche Werte: advanced
- postbackTyp: string
_url URL zum Senden von Aufgabenergebnissen Optionales Feld Sobald die Aufgabe abgeschlossen ist, senden wir eine POST-Anfrage mit den im gzip-Format komprimierten Ergebnissen an die von Ihnen angegebene postback_url. Sie können die Zeichenfolge ‘$id’ als $id-Variable und ‘$tag’ als urlencodierte $tag-Variable verwenden. Wir setzen die erforderlichen Werte vor dem Senden der Anfrage. Beispiel: http://your-server.com/postbackscript?id=$id http://your-server.com/postbackscript?id=$id&tag=$tag Hinweis: Sonderzeichen in postback_url werden urlencodiert; u. a. wird das Zeichen # in %23 kodiert. Weitere Informationen finden Sie in unserem Help Center.
- priorityTyp: integer
Aufgabenpriorität Optionales Feld Kann folgende Werte annehmen: 1 – normale Ausführungspriorität (standardmäßig gesetzt) 2 – hohe Ausführungspriorität Für Aufgaben mit hoher Ausführungspriorität wird zusätzlich berechnet. Die Kosten lassen sich auf der Seite Pricing berechnen.
- productTyp: string
_id Eindeutiger Produktbezeichner bei Google Shopping Optionales Feld Wir empfehlen, product_id zusammen mit data_docid und gid anzugeben, um optimale Ergebnisse zu erzielen; diesen Wert erhalten Sie für ein bestimmtes Produkt durch eine separate Anfrage an den Endpunkt Google Shopping Products Beispiel: 4485466949985702538 Weitere Informationen zum Parameter finden Sie in dieser Hilfe-Center-Anleitung
- seTyp: string
_domain Suchmaschinen-Domain Optionales Feld Wir wählen die passende Suchmaschinen-Domain automatisch anhand des von Ihnen angegebenen Standorts und der Sprache aus. Sie können in diesem Feld jedoch eine benutzerdefinierte Suchmaschinen-Domain festlegen. Beispiel: google.co.uk, google.com.au, google.de usw.
- tagTyp: string
Benutzerdefinierte Aufgaben-ID. Optionales Feld. Das Zeichenlimit beträgt 255. Mit diesem Parameter können Sie die Aufgabe identifizieren und dem Ergebnis zuordnen. Den angegebenen Wert tag finden Sie im data-Objekt der Antwort.
Leeres ObjektLeeres Objekt
- Typ: object200
Erfolgreiche Antwort
- Typ: numbercost
Gesamtkosten der Aufgaben in USD
- Typ: integerstatus
_code Allgemeiner Statuscode. Die vollständige Liste der Antwortcodes finden Sie hier. Hinweis: Wir empfehlen dringend, ein geeignetes System zur Behandlung zugehöriger Ausnahme- oder Fehlerbedingungen zu entwickeln.
- Typ: stringstatus
_message Allgemeine Informationsmeldung. Die vollständige Liste der allgemeinen Informationsmeldungen finden Sie hier.
- Typ: array string[]tasks
Array der Aufgaben
- Typ: integertasks
_count Die Anzahl der Aufgaben im tasksarray
- Typ: integertasks
_error Die Anzahl der Aufgaben im tasks-Array, die mit einem Fehler zurückgegeben wurden
- Typ: numbertasks
.cost Kosten der Aufgabe in USD
- Typ: objecttasks
.data Enthält dieselben Parameter, die Sie in der POST-Anfrage angegeben haben
- Typ: stringtasks
.id Eindeutiger Aufgabenbezeichner in unserem System im Format Universally unique identifier (UUID)
- Typ: array string[]tasks
.path URL-Pfad
- Typ: array string[]tasks
.result Array von Ergebnissen. In diesem Fall ist der Wert null
- Typ: integertasks
.result _count Anzahl der Elemente im Ergebnis-Array
- Typ: integertasks
.status _code Von DataForSEO generierter Statuscode der Aufgabe; kann im folgenden Bereich liegen: 10000-60000
- Typ: stringtasks
.status _message Informationsmeldung zur Aufgabe
- Typ: stringtasks
.time Ausführungszeit in Sekunden
- Typ: stringtime
Ausführungszeit in Sekunden
- Typ: stringversion
Die aktuelle Version der API
application/json - 400
Die Anfrage konnte nicht verarbeitet werden. Prüfen Sie die Anfrageparameter.
- 401
Ein gültiger Felo-API-Schlüssel ist erforderlich.
- 402
Die Anfrage kann nicht fortgesetzt werden, da eine Abrechnungsvoraussetzung nicht erfüllt ist.
- 403
Das Konto ist für diesen Vorgang nicht berechtigt.
- 429
Ein Anfrage- oder Ausgabenlimit wurde erreicht.
- 502
Der Dienst konnte die Anfrage nicht abschließen.
- 503
Die API oder der Abrechnungsdienst ist vorübergehend nicht verfügbar.
- 504
Beim Verarbeiten der Anfrage ist eine Zeitüberschreitung aufgetreten.
- default
Fehlerantwort; Upstream-Passthrough-Antworten können Anbieterformate verwenden
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"
]
}