keyword を指定しない場合は必須フィールドHotel_Review-g60763-d23462501-Reviews-Margaritaville_Times_Square-New_York_City_New_York.htmlhttps://www.tripadvisor.com/Hotel_Review-g60763-d23462501-Reviews-Margaritaville_Times_Square-New_York_City_New_York.html"
},
"keyword": {
"type": "string",
"description": "キーワードurl_path を指定しない場合は必須フィールドkeyword フィールドには最大 700 文字まで指定できます；keyword に “%” 文字を使用する場合は “%25” と指定してください"
},
"location_name": {
"type": "string",
"description": "検索エンジンのロケーションの正式名location_code または url_path を指定しない場合は必須フィールドlocation_name を含む利用可能なロケーションの一覧は、https://api.dataforseo.com/v3/business_data/tripadvisor/locations に個別にリクエストして取得できますLondon,England,United Kingdom"
},
"location_code": {
"type": "integer",
"description": "検索エンジンのロケーションコードlocation_name または url_path を指定しない場合は必須フィールドlocation_code を含む利用可能なロケーションの一覧は、https://api.dataforseo.com/v3/business_data/tripadvisor/locations に個別にリクエストして取得できます1003854"
},
"priority": {
"type": [
"integer",
"null"
],
"description": "タスクの優先度language_name を付した利用可能な言語のリストは、https://api.dataforseo.com/v3/business_data/tripadvisor/languages に個別にリクエストして取得できますEnglishlanguage_code を付した利用可能な言語のリストは、https://api.dataforseo.com/v3/business_data/tripadvisor/languages に個別にリクエストして取得できますen10；4490excellent、very_good、average、poor、terriblefamilies、couples、solo、business、friendsjanuary、february、march、april、may、april、june、july、august、september、october、november、decembermost_recentdetailed_reviews"
},
"translate_reviews": {
"type": [
"boolean",
"null"
],
"description": "URL パスに従ってレビューを翻訳true に設定すると、返されるレビューは指定した url_path に対応する言語に翻訳されます；url_path に tripadvisor.it が含まれ、translate_reviews が true の場合、レビューはイタリア語に翻訳されます；truetag の値は、レスポンスの data オブジェクトに含まれます"
},
"postback_url": {
"type": [
"string",
"null"
],
"description": "タスク結果送信用の URLgzip 形式で圧縮し、指定した postback_url に POST リクエストを送信します$id 変数として、‘$tag’ を URL エンコードされた $tag 変数として使用できます。リクエストの送信前に必要な値を設定します。http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tagpostback_url 内の特殊文字は URL エンコードされます# 文字は %23 にエンコードされます詳細については、ヘルプセンターを参照してください"
},
"pingback_url": {
"type": [
"string",
"null"
],
"description": "タスク完了通知の URL
任意フィールド
タスクが完了すると、指定した URL に GET リクエストを送信して通知します
‘$id’ 文字列を $id 変数として、‘$tag’ を URL エンコードされた $tag 変数として使用できます。リクエストの送信前に必要な値を設定します。
例:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
注意: pingback_url 内の特殊文字は URL エンコードされます
たとえば、# 文字は %23 にエンコードされます
詳細については、ヘルプセンターを参照してください"
}
},
"example": [
{
"url_path": "Hotel_Review-g60763-d23462501-Reviews-Margaritaville_Times_Square-New_York_City_New_York.html",
"location_code": 1003854,
"pingback_url": "https://your-server.com/pingback.php?id=$id&tag=$tag",
"tag": "some_string_123"
}
]
}
]
},
"example": [
{
"url_path": "Hotel_Review-g60763-d23462501-Reviews-Margaritaville_Times_Square-New_York_City_New_York.html",
"location_code": 1003854,
"pingback_url": "https://your-server.com/pingback.php?id=$id&tag=$tag",
"tag": "some_string_123"
}
]
}
```
## Responses
### 200 — 操作成功
Headers:
- `X-Request-Id` (string) — Felo サポートに問い合わせる際に伝えるリクエスト識別子。
**application/json**
Schema: object | null
```json
{
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_BusinessDataTripadvisorReviewsTaskPostResponseInfo"
}
]
}
```
### 400 — リクエストを処理できませんでした。リクエストパラメータを確認してください。
### 401 — 有効な Felo API キーが必要です。
### 402 — 請求要件が満たされていないため、リクエストを続行できません。
### 403 — このアカウントにはこの操作を行う権限がありません。
### 429 — リクエストまたは支出の上限に達しました。
### 502 — サービスがリクエストを完了できませんでした。
### 503 — API または請求サービスが一時的に利用できません。
### 504 — リクエストの処理中にサービスがタイムアウトしました。
### default — エラーレスポンス。上流のパススルーレスポンスはプロバイダーの形式を使用する場合があります
**application/json**
Schema:
```json
{}
```
## Schema definitions
### Response36Afe1097B20_BaseResponseInfo
`#/components/schemas/Response36Afe1097B20_BaseResponseInfo`
```json
{
"properties": {
"version": {
"type": [
"string",
"null"
],
"description": "API の現在のバージョン"
},
"status_code": {
"type": [
"integer",
"null"
],
"description": "一般的なステータスコード\nレスポンスコードの完全な一覧はこちらです"
},
"status_message": {
"type": [
"string",
"null"
],
"description": "一般的な情報メッセージ\n一般的な情報メッセージの完全な一覧はこちらです"
},
"time": {
"type": [
"string",
"null"
],
"description": "合計実行時間（秒）"
},
"cost": {
"type": [
"number",
"null"
],
"description": "タスクの総コスト（USD）",
"format": "double"
},
"tasks_count": {
"type": [
"integer",
"null"
],
"description": "tasks 配列内のタスク数",
"format": "int64"
},
"tasks_error": {
"type": [
"integer",
"null"
],
"description": "エラーで返された tasks 配列内のタスク数",
"format": "int64"
}
}
}
```
### Response36Afe1097B20_BaseResponseTaskInfo
`#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo`
```json
{
"properties": {
"id": {
"type": [
"string",
"null"
],
"description": "タスク識別子\n当社システム内で UUID 形式の一意のタスク識別子"
},
"status_code": {
"type": [
"integer",
"null"
],
"description": "タスクのステータスコード\nDataForSEO によって生成され、次の範囲の値になります: 10000-60000\nレスポンスコードの完全な一覧はこちらです"
},
"status_message": {
"type": [
"string",
"null"
],
"description": "タスクの情報メッセージ\n一般的な情報メッセージの完全な一覧はこちらです"
},
"time": {
"type": [
"string",
"null"
],
"description": "実行時間（秒）"
},
"cost": {
"type": [
"number",
"null"
],
"description": "タスクの総コスト（USD）",
"format": "double"
},
"result_count": {
"type": [
"integer",
"null"
],
"description": "result 配列内の要素数",
"format": "int64"
},
"path": {
"type": [
"array",
"null"
],
"items": {
"type": [
"string",
"null"
]
},
"description": "URL パス"
},
"data": {
"type": [
"object",
"null"
],
"additionalProperties": {
"type": [
"object",
"null"
]
},
"description": "POST リクエストで指定したものと同じパラメーターを含みます"
}
}
}
```
### Response36Afe1097B20_BusinessDataTripadvisorReviewsTaskPostResponseInfo
`#/components/schemas/Response36Afe1097B20_BusinessDataTripadvisorReviewsTaskPostResponseInfo`
```json
{
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseInfo"
},
{
"type": "object",
"properties": {
"tasks": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_BusinessDataTripadvisorReviewsTaskPostTaskInfo"
}
]
},
"description": "タスクの配列"
}
}
}
]
}
```
### Response36Afe1097B20_BusinessDataTripadvisorReviewsTaskPostTaskInfo
`#/components/schemas/Response36Afe1097B20_BusinessDataTripadvisorReviewsTaskPostTaskInfo`
```json
{
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo"
},
{
"type": "object",
"properties": {
"result": {
"type": [
"object",
"null"
],
"description": "結果の配列
この場合、値は null になります"
}
}
}
]
}
```