Google Shopping Product Info-Aufgaben einstellen
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Google Shopping Product Info-Aufgaben einstellen
Stellt die Suche nach einem bestimmten Google Shopping-Produkt in die Warteschlange und gibt eine Aufgaben-id zurück. Identifizieren Sie das Produkt mit product_id und der gid oder data_docid aus einem Ergebnis von get_dataforseo_merchant_google_products_fetch. 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_product_info_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 | null)[]
- dataTyp: string
_docid eindeutige Kennung des SERP-Datenelements
Pflichtfeld, wennproduct_idodergidnicht angegeben ist
Für optimale Ergebnisse empfehlen wir,data_docidzusammen mitproduct_idundgidanzugeben;
Diesen Wert für ein bestimmtes Element erhalten Sie durch eine separate Anfrage an den Google Shopping Products-Endpunkt
Beispiel:13071766526042404278 - gidTyp: string
globale Produktkennung bei Google Shopping
Pflichtfeld, wennproduct_idoderdata_docidnicht angegeben ist
Für optimale Ergebnisse empfehlen wir,gidzusammen mitproduct_idunddata_docidanzugeben;
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 - languageTyp: string
_code Sprachcode
Pflichtfeld, wenn Sielanguage_namenicht angeben
Wenn Sie dieses Feld verwenden, müssen Sielanguage_namenicht angeben
Die Liste der verfügbaren Google Shopping-Sprachen mit ihrenlanguage_code_erhalten Sie durch eine separate Anfrage anhttps://api.dataforseo.com/v3/merchant/google/languages
Beispiel:en - languageTyp: string
_name Vollständiger Name der Sprache
Pflichtfeld, wenn Sielanguage_codenicht angeben
Wenn Sie dieses Feld verwenden, müssen Sielanguage_codenicht angeben
Die Liste der verfügbaren Google Shopping-Sprachen mit ihrenlanguage_nameerhalten Sie durch eine separate Anfrage anhttps://api.dataforseo.com/v3/merchant/google/languages
Beispiel:English - locationTyp: integer
_code Standortcode
Pflichtfeld, wenn Sielocation_name_oderlocation_coordinatenicht angeben
Wenn Sie dieses Feld verwenden, müssen Sielocation_nameoderlocation_coordinatenicht angeben
Die Liste der verfügbaren Google Shopping-Standorte mit ihrenlocation_codeerhalten Sie durch eine separate Anfrage anhttps://api.dataforseo.com/v3/merchant/google/locations
Beispiel:2840 - locationTyp: string
_coordinate GPS-Koordinaten eines Standorts
Pflichtfeld, wenn Sielocation_name_oderlocation_codenicht angeben
Wenn Sie dieses Feld verwenden, müssen Sielocation_nameoderlocation_codenicht angeben
Der Parameterlocation_coordinatemuss 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 Standorts
Pflichtfeld, wenn Sielocation_codeoderlocation_coordinatenicht angeben
Wenn Sie dieses Feld verwenden, müssen Sielocation_codeoderlocation_coordinatenicht angeben
Die Liste der verfügbaren Google Shopping-Standorte mit ihrenlocation_nameerhalten Sie durch eine separate Anfrage anhttps://api.dataforseo.com/v3/merchant/google/locations
Beispiel:London,England,United Kingdom - pingbackTyp: string | null
_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 URL-kodierte$tag-Variable verwenden. Wir setzen die erforderlichen Werte vor dem Senden der Anfrage.
Beispiel:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Hinweis: Sonderzeichen inpingback_urlwerden URL-kodiert;
d. h. das Zeichen#wird zu%23kodiert - postbackTyp: string | null
_data postback_url-Datentyp
Optionales Feld
entspricht dem Datentyp, der an Ihren Server gesendet wird
mögliche Werte:advanced - postbackTyp: string | null
_url URL zum Senden von Aufgabenergebnissen
Optionales Feld
Sobald die Aufgabe abgeschlossen ist, senden wir eine POST-Anfrage mit den imgzip-Format komprimierten Ergebnissen an die von Ihnen angegebenepostback_url
Sie können die Zeichenfolge ‘$id’ als$id-Variable und ‘$tag’ als URL-kodierte$tag-Variable verwenden. Wir setzen die erforderlichen Werte vor dem Senden der Anfrage.
Beispiel:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Hinweis: Sonderzeichen inpostback_urlwerden URL-kodiert;
d. h. das Zeichen#wird zu%23kodiert - priorityTyp: integer | null
- productTyp: string
_id eindeutige Produktkennung bei Google Shopping
Pflichtfeld, wenndata_docidodergidnicht angegeben ist
Für optimale Ergebnisse empfehlen wir,product_idzusammen mitdata_docidundgidanzugeben;
Diesen Wert für ein bestimmtes Produkt erhalten Sie durch eine separate Anfrage an den Google Shopping Products-Endpunkt
Beispiel:4485466949985702538
Weitere Informationen zum Parameter finden Sie in dieser Help-Center-Anleitung - seTyp: string | null
_domain Domain der Suchmaschine
Optionales Feld
Wir wählen die relevante Suchmaschinendomäne automatisch anhand des von Ihnen angegebenen Standorts und der Sprache aus
Sie können in diesem Feld jedoch eine benutzerdefinierte Suchmaschinendomäne festlegen
Beispiel:google.co.uk,google.com.au,google.deusw. - tagTyp: string | null
Benutzerdefinierte Aufgaben-ID
Optionales Feld
Zeichenlimit: 255
Mit diesem Parameter können Sie die Aufgabe identifizieren und dem Ergebnis zuordnen
Den angegebenen Werttagfinden Sie imdata-Objekt der Antwort
- Typ: object | null · Response36Afe1097B20_MerchantGoogleProductInfoTaskPostResponseInfo200
- Typ: number | null Format: doublecost
Gesamtkosten der Aufgaben in USD
- Typ: integer | nullstatus
_code allgemeiner Statuscode die vollständige Liste der Antwortcodes finden Sie hier
- Typ: string | nullstatus
_message allgemeine Informationsmeldung die vollständige Liste der allgemeinen Informationsmeldungen finden Sie hier
- Typ: array (object | null)[] | nulltasks
Array von Aufgaben
- Typ: object | null · Response36Afe1097B20_MerchantGoogleProductInfoTaskPostTaskInfo
- costTyp: number | null Format: double
Gesamtkosten der Aufgaben in USD
- dataTyp: object | null
Enthält dieselben Parameter, die Sie in der POST-Anfrage angegeben haben
- propertyTyp: object | null
Name
- idTyp: string | null
Aufgaben-ID eindeutige Aufgaben-ID in unserem System im UUID-Format
- pathTyp: array (string | null)[] | null
URL-Pfad
- resultTyp: object | null
Array von Ergebnissen
in diesem Fall ist der Wertnull - resultTyp: integer | null Format: int64
_count Anzahl der Elemente im Ergebnis-Array
- statusTyp: integer | null
_code Statuscode der Aufgabe von DataForSEO erzeugt, kann im folgenden Bereich liegen: 10000-60000 die vollständige Liste der Antwortcodes finden Sie hier
- statusTyp: string | null
_message Informationsmeldung der Aufgabe die vollständige Liste der allgemeinen Informationsmeldungen finden Sie hier
- timeTyp: string | null
Ausführungszeit in Sekunden
- Typ: integer | null Format: int64tasks
_count Die Anzahl der Aufgaben im tasks-Array
- Typ: integer | null Format: int64tasks
_error Die Anzahl der Aufgaben im tasks-Array, die mit einem Fehler zurückgegeben wurden
- Typ: string | nulltime
Gesamtausführungszeit, Sekunden
- Typ: string | nullversion
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/product_info/task_post \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en",
"location_code": 2840,
"product_id": "1113158713975221117"
}
]'
{
"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": null
}
]
}