payload.country folgt den Länderregeln und Standardwerten der jeweiligen Engine. Doubao fragt immer vom chinesischen Festland aus. payload.state fragt bei unterstützten Engines aus einem US-Bundesstaat. Prüfen Sie vor dem Einreichen die Regeln der Engine unten.
Land
Senden Sie einen ISO-3166-1-Alpha-2-Code inpayload.country:
400 VALIDATION_ERROR. Standard und Bedeutung von country hängen von der Engine ab:
Nicht unterstützte Länder
Eine nicht bedienbare Kombination austaskType und country liefert beim Einreichen 422 REGION_UNSUPPORTED. Ein erneuter Versuch hilft nicht.
Lesen Sie
countries.policy für jede Engine in GET /v1/capabilities: only listet unterstützte Länder auf, all_except die Ausnahmen. Commerce listet die Länder des gesamten Katalogs auf; jede Anfrage muss weiterhin zum Shop oder zur Produkt-URL passen. Länderannahme und Ausführungsort folgen den obigen Regeln der Engine. Der folgende Fehler enthält die Ursache in details:
US-Bundesstaat
Geben Sie inpayload.state den zweistelligen Code eines US-Bundesstaats an, um aus diesem Bundesstaat zu fragen. Die Engine antwortet wie einem Nutzer dort, sodass „in der Nähe“-Fragen Orte in diesem Bundesstaat liefern. state gehört zu country US, das auch der Standardwert ist. Diese Anfrage fragt ChatGPT aus Texas:
Das Ergebnis liefert denselben Code als
state zurück. Ein Task mit state kostet 1 Credit mehr als der Preis der Engine. Ein Code, der kein US-Bundesstaat ist, ein anderes country als US oder state zusammen mit uule liefern 400 VALIDATION_ERROR. GET /v1/states?country=US listet die 50 Bundesstaaten und DC.
Googles uule
GOOGLE_AIO, GOOGLE_AIMODE und GOOGLE_SERP akzeptieren außerdem payload.uule, Googles eigenen Standortparameter, für Systeme, die bereits einen pro Ort speichern. Senden Sie den w+-Wert genau so, wie er in eine Google-Such-URL eingesetzt wird. Google erhält ihn unverändert, sodass Ergebnisseite, AI Overview und AI Mode für diesen Ort antworten; country legt weiterhin den Markt fest. Diese Anfrage fragt aus Austin, Texas:
uule zurück. Senden Sie entweder uule oder state; eine Anfrage mit beiden liefert 400 VALIDATION_ERROR, ebenso ein Wert, der kein UULE in w+-Form ist, etwa das prozentkodierte w%2B…. Andere Engines lehnen das Feld mit 422 LOCATION_UNSUPPORTED ab.
GOOGLE_PLACES akzeptiert uule auf dieselbe Weise oder stattdessen city, einen Ortsnamen wie "Reno, Nevada, United States". Jede Seite seiner Liste wird aus diesem Ort gesucht.
Was jede Engine bedient
GET /v1/capabilities liefert jeden öffentlichen taskType mit Aliasen, Eingabefeldern, Preis, Standortunterstützung und Länderregel. Der Endpunkt braucht keinen API-Schlüssel, liest dieselben Regeln, die beim Einreichen gelten, und darf 5 Minuten gecacht werden. Mit ?taskType= erhalten Sie eine einzelne Engine; Aliase werden akzeptiert.
Ein unbekannter
taskType liefert 400 VALIDATION_ERROR. Siehe auch die Capabilities-Referenz.