# Tạo tác vụ đánh giá Google của Business Data

**API:** Data API

**Endpoint:** `POST /v1/beta/dataforseo/business_data/google/reviews/task_post`

**Tags:** DataForSEO

Xếp hàng đánh giá Hồ sơ doanh nghiệp Google, trả về `id` tác vụ. Được bọc trong envelope của DataForSEO: dữ liệu nằm trong `tasks[0].result`, kết quả trong `tasks[0].status_code` - yêu cầu bị từ chối vẫn trả về HTTP 200. Lấy kết quả bằng `get_dataforseo_business_google_reviews_fetch`; bản thân hồ sơ là `post_dataforseo_business_google_gmb_info_live`.

### Tham chiếu giá

- Cách tính: chi phí phản hồi được báo cáo.
- Ước tính tham chiếu mỗi yêu cầu: 0,06 USD.
- Hệ số tham chiếu cho khách hàng: 1,0. Không áp dụng lại hệ số này 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

- [bài viết Trung tâm trợ giúp này](<https://dataforseo.com/help-center/rules-and-limitations-of-keyword-and-keywords-fields-in-dataforseo-apis>)
- [bài viết Trung tâm trợ giúp này](<https://dataforseo.com/help-center/what-is-cid-place-id-feature-id>)
- [Bảng giá](<https://dataforseo.com/pricing/business-data/google-reviews-api>)
- [Trung tâm trợ giúp](<https://dataforseo.com/help-center/pingbacks-postbacks-with-dataforseo-api>)

## Base URL

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

## Authentication

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

## Request body

Required: **no**

### application/json

Schema:

```json
{
  "type": "array",
  "items": {
    "type": [
      "object",
      "null"
    ],
    "oneOf": [
      {
        "type": "object",
        "properties": {
          "keyword": {
            "type": "string",
            "description": "<em>từ khóa</em><br><strong>trường bắt buộc nếu bạn không chỉ định <code>cid</code> hoặc <code>place_id</code></strong><br>từ khóa bạn chỉ định phải cho biết tên của cơ sở địa phương;<br>bạn có thể chỉ định <strong>tối đa 700 ký tự</strong> trong trường <code>keyword</code>;<br>mọi %## sẽ được giải mã (ký tự ‘+’ cũng sẽ được giải mã thành ký tự khoảng trắng)<br>nếu bạn cần dùng ký tự “%” cho <code>keyword</code>, hãy chỉ định dưới dạng “%25”;<br> <br>nếu trường này chứa các tham số như ‘allinanchor:’, ‘allintext:’, ‘allintitle:’, ‘allinurl:’, ‘define:’, ‘filetype:’, ‘id:’, ‘inanchor:’, ‘info:’, ‘intext:’, ‘intitle:’, ‘inurl:’, ‘link:’, ‘related:’, ‘site:’, <strong>phí mỗi tác vụ sẽ được nhân với 5</strong><br>Lưu ý: các truy vấn chứa tham số ‘cache:’ không được hỗ trợ và sẽ trả về lỗi xác thực<p>tìm hiểu thêm về quy tắc và giới hạn của các trường <code>keyword</code> và <code>keywords</code> trong API DataForSEO tại bài viết Trung tâm trợ giúp này"
          },
          "cid": {
            "type": "string",
            "description": "<i>mã định danh duy nhất do Google xác định của thực thể doanh nghiệp</i><br><strong>trường bắt buộc nếu bạn không chỉ định <code>keyword</code> hoặc <code>place_id</code></strong><br>ví dụ:<br><code>194604053573767737</code><br>tìm hiểu thêm về mã định danh tại bài viết Trung tâm trợ giúp này"
          },
          "place_id": {
            "type": "string",
            "description": "<i>mã định danh của thực thể doanh nghiệp trong Google Maps</i><br><strong>trường bắt buộc nếu bạn không chỉ định <code>keyword</code> hoặc <code>cid</code></strong><br>ví dụ:<br><code>GhIJQWDl0CIeQUARxks3icF8U8A</code><br>tìm hiểu thêm về mã định danh tại bài viết Trung tâm trợ giúp này"
          },
          "priority": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>độ ưu tiên tác vụ</em><br>trường tùy chọn<br>có thể nhận các giá trị sau:<br>1 – độ ưu tiên thực thi bình thường (đặt mặc định)<br>2 – độ ưu tiên thực thi cao Bạn sẽ bị tính phí bổ sung cho các tác vụ có độ ưu tiên thực thi cao.<br>Chi phí có thể được tính trên trang Bảng giá."
          },
          "location_name": {
            "type": "string",
            "description": "<em>tên đầy đủ của vị trí công cụ tìm kiếm</em><br><strong>trường bắt buộc nếu bạn không chỉ định</strong> <code>location_code</code> hoặc <code>location_coordinate</code><br><strong>nếu bạn dùng trường này, bạn không cần chỉ định <code>location_code</code> hoặc <code>location_coordinate</code></strong><br>bạn có thể nhận danh sách vị trí khả dụng với <code>location_name</code> bằng cách gửi một yêu cầu riêng đến <code>https://api.dataforseo.com/v3/business_data/google/locations</code><br>ví dụ:<br><code class=\"long-string\">London,England,United Kingdom</code>"
          },
          "location_code": {
            "type": "integer",
            "description": "<em>mã vị trí của công cụ tìm kiếm</em><br><strong>trường bắt buộc nếu bạn không chỉ định</strong> <code>location_name</code> hoặc <code>location_coordinate</code><br><strong>nếu bạn dùng trường này, bạn không cần chỉ định <code>location_name</code> hoặc <code>location_coordinate</code></strong><br>bạn có thể nhận danh sách vị trí khả dụng với <code>location_code</code> bằng cách gửi một yêu cầu riêng đến <code>https://api.dataforseo.com/v3/business_data/google/locations</code><br>ví dụ:<br><code class=\"long-string\">2840</code>"
          },
          "location_coordinate": {
            "type": "string",
            "description": "<em>tọa độ GPS của một vị trí</em><br><strong>trường bắt buộc nếu bạn không chỉ định</strong> <code>location_name</code> hoặc <code>location_code</code><br><strong>nếu bạn dùng trường này, bạn không cần chỉ định <code>location_name</code> hoặc <code>location_code</code></strong><br>tham số <code>location_coordinate</code> phải được chỉ định ở định dạng <em>\"latitude,longitude,radius\"</em><br>số chữ số thập phân tối đa cho <em>\"latitude\"</em> và <em>\"longitude\"</em>: 7<br>giá trị tối thiểu cho <em>\"radius\"</em>: 199.9<br>ví dụ:<br><code class=\"long-string\">53.476225,-2.243572,200</code>"
          },
          "language_name": {
            "type": "string",
            "description": "<em>tên đầy đủ của ngôn ngữ công cụ tìm kiếm</em><br><strong>trường bắt buộc nếu bạn không chỉ định</strong> <code>language_code</code><br><strong>nếu bạn dùng trường này, bạn không cần chỉ định <code>language_code</code></strong><br>bạn có thể nhận danh sách ngôn ngữ khả dụng cùng <code>language_name</code> bằng cách gửi một yêu cầu riêng đến <code>https://api.dataforseo.com/v3/business_data/google/languages</code><br>ví dụ:<br><code class=\"long-string\">English</code>"
          },
          "language_code": {
            "type": "string",
            "description": "<em>mã ngôn ngữ của công cụ tìm kiếm</em><br><strong>trường bắt buộc nếu bạn không chỉ định</strong> <code>language_name</code><br><strong>nếu bạn dùng trường này, bạn không cần chỉ định <code>language_name</code></strong><br>bạn có thể nhận danh sách ngôn ngữ khả dụng cùng <code>language_code</code> của chúng bằng cách gửi một yêu cầu riêng đến <code>https://api.dataforseo.com/v3/business_data/google/languages</code><em><br></em>ví dụ:<em><br></em><code class=\"long-string\">en</code>"
          },
          "depth": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>độ sâu phân tích</em><br>trường tùy chọn<br>số đánh giá trong SERP<br>chúng tôi đặc biệt khuyên đặt độ sâu phân tích theo bội số của mười, vì hệ thống của chúng tôi xử lý mười đánh giá liên tiếp<br>giá trị mặc định: <code>10</code><br>giá trị tối đa: <code>4490</code><br><strong>Tài khoản của bạn sẽ bị tính phí theo từng SERP chứa tối đa 10 kết quả;</strong> <br>Đặt độ sâu trên 10 có thể phát sinh thêm phí nếu công cụ tìm kiếm trả về hơn 10 kết quả</a>;<br>Chi phí có thể được tính trên trang Bảng giá."
          },
          "sort_by": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>tham số sắp xếp kết quả</em><br>trường tùy chọn<br>bạn có thể dùng trường này để sắp xếp kết quả<br>các kiểu sắp xếp khả dụng:<br><code>newest</code> – sắp xếp theo mới nhất trước<br><code>highest_rating</code> – sắp xếp theo điểm đánh giá cao nhất<br><code>lowest_rating</code> – sắp xếp theo điểm đánh giá thấp nhất<br><code>relevant</code> – sắp xếp theo mức liên quan<br>giá trị mặc định: <code>relevant</code>"
          },
          "tag": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>mã định danh tác vụ do người dùng xác định</em><br>trường tùy chọn<br><em>giới hạn ký tự là 255</em><br>bạn có thể dùng tham số này để nhận diện tác vụ và khớp với kết quả<br>bạn sẽ thấy giá trị <code>tag</code> đã chỉ định trong đối tượng <code>data</code> của phản hồi"
          },
          "postback_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>URL để gửi kết quả tác vụ</em><br>trường tùy chọn<br>khi tác vụ hoàn tất, chúng tôi sẽ gửi yêu cầu POST với kết quả được nén ở định dạng <code>gzip</code> đến <code>postback_url</code> bạn đã chỉ định<br>bạn có thể dùng chuỗi ‘$id’ làm biến <code>$id</code> và ‘$tag’ làm biến <code>$tag</code> được mã hóa URL. Chúng tôi sẽ đặt các giá trị cần thiết trước khi gửi yêu cầu.<br>ví dụ:<br><code>http://your-server.com/postbackscript?id=$id</code><br><code>http://your-server.com/postbackscript?id=$id&amp;tag=$tag</code><br><strong>Lưu ý:</strong> các ký tự đặc biệt trong <code>postback_url</code> sẽ được mã hóa URL; <br>tức là, ký tự <code>#</code> sẽ được mã hóa thành <code>%23</code><p>tìm hiểu thêm trên Trung tâm trợ giúp của chúng tôi"
          },
          "pingback_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>URL thông báo của tác vụ đã hoàn tất</em><br>trường tùy chọn<br>khi tác vụ hoàn tất, chúng tôi sẽ thông báo cho bạn bằng yêu cầu GET gửi đến URL bạn đã chỉ định<br>bạn có thể dùng chuỗi ‘$id’ làm biến <code>$id</code> và ‘$tag’ làm biến <code>$tag</code> được mã hóa URL. Chúng tôi sẽ đặt các giá trị cần thiết trước khi gửi yêu cầu.<br>ví dụ:<br><code>http://your-server.com/pingscript?id=$id</code><br><code>http://your-server.com/pingscript?id=$id&amp;tag=$tag</code><br><strong>Lưu ý:</strong> các ký tự đặc biệt trong <code>pingback_url</code> sẽ được mã hóa URL; <br>tức là, ký tự <code>#</code> sẽ được mã hóa thành <code>%23</code><p>tìm hiểu thêm trên Trung tâm trợ giúp của chúng tôi"
          }
        },
        "example": [
          {
            "location_name": "London,England,United Kingdom",
            "language_name": "English",
            "keyword": "hedonism wines",
            "depth": 50,
            "sort_by": "highest_rating"
          }
        ]
      }
    ]
  },
  "example": [
    {
      "location_name": "London,England,United Kingdom",
      "language_name": "English",
      "keyword": "hedonism wines",
      "depth": 50,
      "sort_by": "highest_rating"
    }
  ]
}
```

## 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_BusinessDataGoogleReviewsTaskPostResponseInfo"
    }
  ]
}
```

### 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_BusinessDataGoogleReviewsTaskPostResponseInfo

`#/components/schemas/Response36Afe1097B20_BusinessDataGoogleReviewsTaskPostResponseInfo`

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

### Response36Afe1097B20_BusinessDataGoogleReviewsTaskPostTaskInfo

`#/components/schemas/Response36Afe1097B20_BusinessDataGoogleReviewsTaskPostTaskInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo"
    },
    {
      "type": "object",
      "properties": {
        "result": {
          "type": [
            "object",
            "null"
          ],
          "description": "<em>mảng kết quả</em><br>trong trường hợp này, giá trị sẽ là <code>null</code>"
        }
      }
    }
  ]
}
```
