Aufgaben für Google Autocomplete einstellen
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Aufgaben für Google Autocomplete einstellen
Stellt die Vorschläge, die Google beim Tippen einer Suchanfrage macht, in die Warteschlange und gibt eine Aufgaben-id in tasks[0].id zurück. Eingebettet in die DataForSEO-Hülle: Daten in tasks[0].result, Ergebnis in tasks[0].status_code – eine abgelehnte Anfrage gibt dennoch HTTP 200 zurück. Der Live-Zwilling antwortet sofort und ist für eine einzelne Anfrage einfacher; nutzen Sie die Warteschlange, wenn der Batch einen Tool-Aufruf überdauern würde.
Preisreferenz
- Abrechnung: Gemeldete Antwortkosten.
- Referenzschätzung pro Anfrage: USD 0.02.
- Referenz-Kundenmultiplikator: 1.0. Nicht erneut auf einen bereits abgerechneten Kundenbetrag anwenden.
Nur Referenzmetadaten, kein Kontenangebot, kein garantierter Preis und keine Ausgabenobergrenze. Ressourcen-Credits sind keine Felo-Credits. Endgültige Abrechnungen richten sich nach den Felo-Abrechnungsbelegen.
- Typ: array (object | null)[]
- clientTyp: string | null
Suchclient für Autovervollständigung
Optionales Feld
die Ergebnisse der Autovervollständigung können je nach Suchclient variieren;
Mögliche Werte:
chrome— wird verwendet, wenn die Google-Suche in Google Chrome geöffnet wird;chrome-omni— wird in der Adressleiste von Chrome verwendet;gws-wiz— wird auf der Startseite der Google-Suche verwendet;gws-wiz-serp— wird auf der Ergebnisseite der Google-Suche verwendet;safari— wird verwendet, wenn die Google-Suche im Safari-Browser geöffnet wird;firefox— wird verwendet, wenn die Google-Suche im Firefox-Browser geöffnet wird;psy-ab— kann verwendet werden, wenn die Google-Suche im Google-Chrome-Browser geöffnet wird;toolbar— gibt XML zurück;youtube— gibt JSONP zurück;gws-wiz-local— wird in Google Local verwendet;img— wird in der Bildersuche von Google verwendet;products-cc— wird in der Google-Shopping-Suche verwendet - cursorTyp: integer | null
_pointer Cursorposition in der Suchleiste
Optionales Feld
die horizontale numerische Position des Cursors innerhalb des Keywords in der Suchleiste;
durch Ändern der Cursorposition erhalten Sie für dasselbe Ausgangs-Keyword unterschiedliche Vorschläge zur Autovervollständigung;
Mindestwert:
0Standardwert: die Nummer des letzten Zeichens des angegebenen
keywordBeispiel:
|which query are s-"cursor_pointer": 0which query is s|-"cursor_pointer": 16which que|ry is s-"cursor_pointer": 9 - keywordTyp: string
keyword
Pflichtfeld
im Feld
keywordkönnen Sie bis zu 700 Zeichen angebenalle %## werden dekodiert (das Zeichen ‘+’ wird zudem in ein Leerzeichen dekodiert)
Wenn Sie das Zeichen “%” für Ihr
keywordbenötigen, geben Sie es als “%25” an;Wenn Sie das Zeichen “+” für Ihr
keywordbenötigen, geben Sie es als “%2B” an;
Mehr über Regeln und Einschränkungen der Felder
keywordundkeywordsin DataForSEO-APIs erfahren Sie in diesem Help-Center-Artikel - languageTyp: string
_code Sprachcode der Suchmaschine
Pflichtfeld, wenn nicht angegeben
language_namebei Verwendung dieses Feldes ist keine Angabe von
language_namenötig;die Liste der verfügbaren Sprachen der Suchmaschine mit ihrem
language_codeerhalten Sie durch eine separate Anfrage an diehttps://api.dataforseo.com/v3/serp/google/languagesBeispiel:
en - languageTyp: string
_name vollständiger Name der Suchmaschinensprache
Pflichtfeld, wenn nicht angegeben
language_codebei Verwendung dieses Feldes ist keine Angabe von
language_codenötig;die Liste der verfügbaren Sprachen der Suchmaschine mit ihrem
language_nameerhalten Sie durch eine separate Anfrage anhttps://api.dataforseo.com/v3/serp/google/languagesBeispiel:
English - locationTyp: integer
_code Standortcode der Suchmaschine
Pflichtfeld, wenn nicht angegeben
location_name;die Liste der verfügbaren Standorte der Suchmaschinen mit ihrem
location_codeerhalten Sie durch eine separate Anfrage anhttps://api.dataforseo.com/v3/serp/google/locationsBeispiel:
2840 - locationTyp: string
_name vollständiger Name des Suchmaschinen-Standorts
Pflichtfeld, wenn nicht angegeben
location_codebei Verwendung dieses Feldes ist keine Angabe von
location_codenötig;die Liste der verfügbaren Standorte der Suchmaschine mit ihrem
location_nameerhalten Sie durch eine separate Anfrage anhttps://api.dataforseo.com/v3/serp/google/autocomplete/locationsBeispiel:
London,England,United Kingdom - pingbackTyp: string | null
_url Benachrichtigungs-URL einer abgeschlossenen 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 legen die erforderlichen Werte vor dem Senden der Anfrage fest.Beispiel:
http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tagHinweis: Sonderzeichen in
pingback_urlwerden URL-kodiert;so wird das Zeichen
#in%23kodiert
mehr dazu in unserem Help-Center
- postbackTyp: string
_data postback_url-Datentyp
Pflichtfeld, wenn
postback_urlangegeben wirdentspricht dem Datentyp, der an Ihren Server gesendet wird
Mögliche Werte:
advanced - postbackTyp: string | null
_url URL zum Senden der Aufgabenergebnisse
Optionales Feld
Sobald die Aufgabe abgeschlossen ist, senden wir eine POST-Anfrage mit den im
gzip-Format komprimierten Ergebnissen an die von Ihnen angegebenepostback_urlSie 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 AnfrageBeispiel:
http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tagHinweis: Sonderzeichen in
postback_urlwerden URL-kodiert;d. h. das Zeichen
#wird in%23kodiert
Weitere Informationen finden Sie in unserem Help Center
- priorityTyp: integer | null
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
- tagTyp: string | null
benutzerdefinierter Aufgabenbezeichner
optionales Feld
Das Zeichenlimit beträgt 255
Sie können diesen Parameter verwenden, um die Aufgabe zu identifizieren und dem Ergebnis zuzuordnen
Den angegebenen
tag-Wert finden Sie imdata-Objekt der Antwort
- Typ: object | null · Response36Afe1097B20_SerpGoogleAutocompleteTaskPostResponseInfo200
- 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_SerpGoogleAutocompleteTaskPostTaskInfo
- 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/serp/google/autocomplete/task_post \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en",
"location_code": 2840,
"keyword": "albert einstein",
"cursor_pointer": 6
}
]'
{
"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
}
]
}