payload.country にはエンジンごとの国のルールと既定値が適用されます。Doubaoは常に中国本土から質問します。payload.state は対応するエンジンで質問する米国の州を指定します。送信前に以下のエンジン別ルールを確認してください。
国
payload.country に ISO 3166-1 alpha-2 コードを送ります。
400 VALIDATION_ERROR を返します。既定値と country の意味はエンジンによって異なります。
非対応の国
提供できないtaskType と country の組み合わせは、送信時に 422 REGION_UNSUPPORTED を返します。再試行しても結果は変わりません。
GET /v1/capabilities の各エンジンの countries.policy を確認してください。only は対応国、all_except は除外国を列挙します。Commerceの一覧はストア全体の国をまとめたもので、各リクエストはストアまたは商品URLの国と一致する必要があります。国の受付条件と実行場所は上記のエンジン別ルールに従います。次のエラーは details に原因を含みます。
米国の州
payload.state に米国の州の2文字コードを指定すると、その州から質問します。エンジンはその州にいるユーザーへの回答を返すため、「近くの」質問にはその州の場所が挙がります。state は country が US のときに使い、US は既定値でもあります。次のリクエストはテキサス州から ChatGPT に質問します。
結果の
state に同じコードが返ります。state を送ったタスクはエンジンの料金に1クレジットが加算されます。米国の州でないコード、US 以外の country、uule と一緒に送った state は 400 VALIDATION_ERROR を返します。GET /v1/states?country=US は50州と DC を返します。
Google の uule
GOOGLE_AIO、GOOGLE_AIMODE、GOOGLE_SERP は、Google 独自の位置パラメータ payload.uule も受け付けます。場所ごとに UULE を保存しているシステム向けです。Google 検索 URL に入れるのと同じ w+ の値をそのまま送ってください。Google はその値をそのまま受け取るため、検索結果ページ、AI Overview、AI Mode がその場所向けに答えます。市場は引き続き country で決まります。次のリクエストはテキサス州オースティンから質問します。
uule に同じ値が返ります。uule と state はどちらか一方だけを送ってください。両方を送ると 400 VALIDATION_ERROR を返し、パーセントエンコードした w%2B… のように w+ 形式の UULE でない値も同じです。その他のエンジンは 422 LOCATION_UNSUPPORTED で拒否します。
GOOGLE_PLACES も同じように uule を受け付け、代わりに "Reno, Nevada, United States" のような場所の名前を city で受け付けます。リストのすべてのページをその場所から検索します。
各エンジンの提供内容を確認する
GET /v1/capabilities は、公開されているすべての taskType について、エイリアス、入力フィールド、料金、位置への対応、国のポリシーを返します。APIキーは不要で、送信を検証するのと同じルールから読み取り、5分間キャッシュできます。?taskType= を付けると1つのエンジンだけを返します。エイリアスも受け付けます。
不明な
taskType は 400 VALIDATION_ERROR を返します。capabilities リファレンスも参照してください。