# Lấy tác vụ SERP Maps đã hoàn tất

**API:** Data API

**Endpoint:** `GET /v1/beta/dataforseo/serp/google/maps/tasks_ready`

**Tags:** DataForSEO

Liệt kê các tác vụ Google Maps đã hoàn tất đang chờ thu thập. Miễn phí. Được bọc trong phong bì của DataForSEO: dữ liệu ở `tasks[0].result`, kết quả ở `tasks[0].status_code` - yêu cầu bị từ chối vẫn trả về HTTP 200. ⚠️ Hiếm khi cần: bên gọi đã giữ `id` do chính mình gửi và có thể truy xuất trực tiếp. Mục này trả lời những gì đã sẵn sàng trên toàn bộ tài khoản.

### Tham chiếu giá

- Đo lường: Chi phí phản hồi được báo cáo.
- Ước tính tham chiếu cho mỗi yêu cầu: USD 0.012.
- Hệ số khách hàng tham chiếu: 1.0. Không áp dụng lại cho số tiền khách hàng đã quyết toán.

Chỉ là siêu dữ liệu tham chiếu, không phải báo giá cho tài khoản, mức giá được bảo đảm hay hạn mức chi tiêu. Tín dụng tài nguyên không phải tín dụng Felo. Khoản phí cuối cùng tuân theo bản ghi thanh toán của Felo.

## Related links

- [UUID](<https://en.wikipedia.org/wiki/Universally_unique_identifier>)

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Responses

### 200 — Thao tác thành công

Headers:
- `X-Request-Id` (string) — Mã định danh yêu cầu cần bao gồm khi liên hệ bộ phận hỗ trợ Felo.

**application/json**

Schema: object | null

```json
{
  "type": [
    "object",
    "null"
  ],
  "oneOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_SerpGoogleMapsTasksReadyResponseInfo"
    }
  ]
}
```

### 400 — Không thể xử lý yêu cầu. Hãy kiểm tra các tham số yêu cầu.

### 401 — Cần có khóa API Felo hợp lệ.

### 402 — Không thể tiếp tục yêu cầu vì chưa đáp ứng yêu cầu thanh toán.

### 403 — Tài khoản không được phép thực hiện thao tác này.

### 429 — Đã đạt giới hạn yêu cầu hoặc giới hạn chi tiêu.

### 502 — Dịch vụ không thể hoàn tất yêu cầu.

### 503 — API hoặc dịch vụ thanh toán tạm thời không khả dụng.

### 504 — Dịch vụ đã hết thời gian chờ khi xử lý yêu cầu.

### default — Phản hồi lỗi; phản hồi chuyển tiếp từ thượng nguồn có thể dùng định dạng của nhà cung cấp

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response36Afe1097B20_BaseResponseInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseInfo`

```json
{
  "properties": {
    "version": {
      "type": [
        "string",
        "null"
      ],
      "description": "phiên bản hiện tại của API"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "mã trạng thái chung; bạn có thể tìm danh sách đầy đủ các mã phản hồi tại đây"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "thông điệp thông tin chung; bạn có thể tìm danh sách đầy đủ các thông điệp thông tin chung tại đây"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "tổng thời gian thực thi, giây"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "tổng chi phí tác vụ, USD",
      "format": "double"
    },
    "tasks_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "số lượng tác vụ trong mảng tasks",
      "format": "int64"
    },
    "tasks_error": {
      "type": [
        "integer",
        "null"
      ],
      "description": "số lượng tác vụ trong mảng tasks được trả về kèm lỗi",
      "format": "int64"
    }
  }
}
```

### Response36Afe1097B20_BaseResponseTaskInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo`

```json
{
  "properties": {
    "id": {
      "type": [
        "string",
        "null"
      ],
      "description": "mã định danh tác vụ; mã định danh tác vụ duy nhất trong hệ thống của chúng tôi ở định dạng UUID"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "mã trạng thái của tác vụ do DataForSEO tạo; có thể nằm trong khoảng sau: 10000-60000; bạn có thể tìm danh sách đầy đủ các mã phản hồi tại đây"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "thông điệp thông tin của tác vụ; bạn có thể tìm danh sách đầy đủ các thông điệp thông tin chung tại đây"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "thời gian thực thi, giây"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "tổng chi phí tác vụ, USD",
      "format": "double"
    },
    "result_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "số phần tử trong mảng kết quả",
      "format": "int64"
    },
    "path": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "Đường dẫn URL"
    },
    "data": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "object",
          "null"
        ]
      },
      "description": "chứa các tham số giống như bạn đã chỉ định trong yêu cầu POST"
    }
  }
}
```

### Response36Afe1097B20_SerpGoogleMapsTasksReadyResponseInfo

`#/components/schemas/Response36Afe1097B20_SerpGoogleMapsTasksReadyResponseInfo`

```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_SerpGoogleMapsTasksReadyTaskInfo"
              }
            ]
          },
          "description": "<em>mảng tác vụ</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_SerpGoogleMapsTasksReadyResultInfo

`#/components/schemas/Response36Afe1097B20_SerpGoogleMapsTasksReadyResultInfo`

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>mã định danh tác vụ của tác vụ đã hoàn thành</em><br><strong>mã định danh tác vụ duy nhất trong hệ thống của chúng tôi ở định dạng UUID</strong>"
    },
    "se": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>công cụ tìm kiếm được chỉ định khi đặt tác vụ</em>"
    },
    "se_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>loại công cụ tìm kiếm</em><br>ví dụ: <code>{{low_se_type_under}}</code>"
    },
    "date_posted": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>ngày tác vụ được đăng (theo định dạng UTC)</em>"
    },
    "tag": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>mã định danh tác vụ do người dùng xác định</em>"
    },
    "endpoint_regular": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>URL để thu thập kết quả của tác vụ SERP Regular</em><br>nếu endpoint đã chỉ định không hỗ trợ SERP Regular, giá trị sẽ là <code>null</code>"
    },
    "endpoint_advanced": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>URL để thu thập kết quả của tác vụ SERP Advanced</em><br>nếu endpoint đã chỉ định không hỗ trợ SERP Advanced, giá trị sẽ là <code>null</code>"
    },
    "endpoint_html": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>URL để thu thập kết quả của tác vụ SERP HTML</em><br>nếu endpoint đã chỉ định không hỗ trợ SERP HTML, giá trị sẽ là <code>null</code>"
    }
  }
}
```

### Response36Afe1097B20_SerpGoogleMapsTasksReadyTaskInfo

`#/components/schemas/Response36Afe1097B20_SerpGoogleMapsTasksReadyTaskInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo"
    },
    {
      "type": "object",
      "properties": {
        "result": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": [
              "object",
              "null"
            ],
            "oneOf": [
              {
                "$ref": "#/components/schemas/Response36Afe1097B20_SerpGoogleMapsTasksReadyResultInfo"
              }
            ]
          },
          "description": "<em>mảng kết quả</em>"
        }
      }
    }
  ]
}
```
