> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 设置 Google My Business 问题与回答任务

> 此端点将提供与 Google My Business 上所列特定商家实体相关的问答详细概览。



## OpenAPI

````yaml openapi/zh/dataforseo.json POST /dataforseo/business_data/google/questions_and_answers/task_post
openapi: 3.0.3
info:
  title: DataForSEO API
  version: 1.0.0
  description: 通过 AIsa 统一网关提供的 DataForSEO API 端点。
servers:
  - url: https://api.aisa.one/apis/v1
security:
  - BearerAuth: []
paths:
  /dataforseo/business_data/google/questions_and_answers/task_post:
    post:
      summary: 设置 Google My Business 问题与回答任务
      description: >-
        此端点将提供与 Google My Business
        上列出的特定商业实体相关的问题和回答的详细概览。通过向此端点提交请求，您可以访问与特定商家相关的咨询和回复的完整数据，包括问题和回答的全文，以及时间戳、用户信息等元数据。
      operationId: post_dataforseo_business_data_google_questions_and_answers_task_post
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                keyword:
                  type: string
                  description: >-
                    *keyword* **必填字段** 你指定的关键词应表示本地商家的名称，最多可指定 **700 个字符**。在
                    `keyword` 字段中，**所有 %## 都会被解码（加号字符“+”会被解码为空格字符）**。如果需要在
                    `keyword` 中使用“%”字符，请将其指定为“%25”；此字段还可用于传递以下参数：`cid`——由 Google
                    定义的唯一商家实体 ID；`place_id`——Google Maps 中商家实体的标识符；`spp`——Google
                    SERP 的 `local_pack`
                    元素中所展示本地服务的唯一标识符。示例：`cid:194604053573767737`
                    `place_id:GhIJQWDl0CIeQUARxks3icF8U8A`
                    `spp:CgsvZy8xdGN4cWRraBoUChIJPZDrEzLsZIgRoNrpodC5P30`。有关
                    `cid` 和 `place_id`
                    标识符的更多信息，请参阅[此帮助中心文章](https://dataforseo.com/help-center/what-is-cid-place-id-feature-id)。有关
                    DataForSEO API 中 `keyword` 和 `keywords`
                    字段的规则与限制，请参阅此[帮助中心文章](https://dataforseo.com/help-center/rules-and-limitations-of-keyword-and-keywords-fields-in-dataforseo-apis)
                priority:
                  type: integer
                  description: >-
                    *任务优先级* 可选字段，可取以下值：1 – 普通执行优先级（默认设置）2 – 高执行优先级
                    高执行优先级的任务将额外收费。费用可在
                    [Pricing](https://dataforseo.com/pricing/business-data/google-questions-and-answers-api-pricing
                    "Pricing") 页面计算。
                location_name:
                  type: string
                  description: >-
                    *搜索引擎位置的完整名称* **如果未指定** `location_code` 或
                    `location_coordinate`，**则为必填字段；如果使用此字段，则无需指定 `location_code`
                    或 `location_coordinate`**。您可以单独向
                    `https://api.dataforseo.com/v3/business_data/google/locations`
                    发出请求，以获取带有 `location_name` 的可用位置列表。示例：`London,England,United
                    Kingdom`
                location_code:
                  type: integer
                  description: >-
                    *搜索引擎位置代码* **如果未指定** `location_name` 或
                    `location_coordinate`，**则为必填字段；如果使用此字段，则无需指定 `location_name`
                    或 `location_coordinate`**。您可以通过向
                    `https://api.dataforseo.com/v3/business_data/google/locations`
                    单独发送请求，获取包含 `location_code` 的可用位置列表。示例：`2840`
                location_coordinate:
                  type: string
                  description: >-
                    *位置的 GPS 坐标* **如果未指定** `location_name` 或 `location_code`
                    **，则为必填字段** **如果使用此字段，则无需指定 `location_name` 或
                    `location_code`** `location_coordinate` 参数应以
                    *“latitude,longitude,radius”* 格式指定 *“latitude”* 和
                    *“longitude”* 的最大小数位数：7 *“radius”* 的最小值：199.9 (mm)
                    *“radius”* 的最大值：199999 (mm) 示例：`53.476225,-2.243572,200`
                language_name:
                  type: string
                  description: >-
                    *搜索引擎语言的完整名称* **未指定** `language_code` **时为必填字段；如果使用此字段，则无需指定
                    `language_code`**；您可以通过向
                    `https://api.dataforseo.com/v3/business_data/google/languages`
                    单独发送请求，获取包含 `language_name` 的可用语言列表；示例：`English`
                language_code:
                  type: string
                  description: >-
                    *搜索引擎语言代码* **如果未指定** `language_name` **，则为必填字段；如果使用此字段，则无需指定
                    `language_name`**；您可以通过向
                    `https://api.dataforseo.com/v3/business_data/google/languages`
                    单独发送请求，获取可用语言及其 `language_code` 的列表；示例：`en`
                depth:
                  type: integer
                  description: >-
                    *解析深度* 可选字段 结果中的问题行数 默认值：`20` 最大值：`700` **您的账户将按每个最多包含 20
                    条结果的 SERP 收费；** 如果搜索引擎返回超过 20 条结果，将 depth 设置为 20
                    以上可能产生额外费用；如果指定的 depth 大于响应中的问题数量，差额将自动退还至您的账户余额；具体费用可在
                    [Pricing](https://dataforseo.com/pricing/business-data/google-questions-and-answers-api-pricing
                    "Pricing") 页面计算。
                tag:
                  type: string
                  description: >-
                    *用户定义的任务标识符*，可选字段，*字符数上限为 255*。你可以使用此参数标识任务并将其与结果匹配；你可以在响应的
                    `data` 对象中找到指定的 `tag` 值
                postback_url:
                  type: string
                  description: >-
                    *用于发送任务结果的返回 URL*，可选字段。任务完成后，我们会向您指定的 `postback_url` 发送 POST
                    请求，结果将以 `gzip` 格式压缩。您可以将字符串 ‘$id’ 用作 `$id` 变量，并将 ‘$tag’ 用作经过
                    URL 编码的 `$tag`
                    变量。我们将在发送请求前设置必要的值。示例：`http://your-server.com/postbackscript?id=$id`
                    `http://your-server.com/postbackscript?id=$id&tag=$tag`
                    **注意：**`postback_url` 中的特殊字符将经过 URL 编码；例如，`#` 字符将编码为
                    `%23`。有关更多信息，请参阅我们的[帮助中心](https://dataforseo.com/help-center/pingbacks-postbacks-with-dataforseo-api)
                pingback_url:
                  type: string
                  description: >-
                    *已完成任务的通知 URL* 可选字段 任务完成后，我们会向您指定的 URL 发送 GET 请求进行通知
                    您可以将字符串‘$id’用作 `$id` 变量，将‘$tag’用作经过 URL 编码的 `$tag`
                    变量。我们会在发送请求前设置必要的值。示例：`http://your-server.com/pingscript?id=$id`
                    `http://your-server.com/pingscript?id=$id&tag=$tag` **注意：**
                    `pingback_url` 中的特殊字符将进行 URL 编码；例如，字符 `#` 将编码为 `%23`
                    更多信息请参阅我们的[帮助中心](https://dataforseo.com/help-center/pingbacks-postbacks-with-dataforseo-api)
              required:
                - keyword
                - location_name
                - location_code
                - location_coordinate
                - language_name
                - language_code
      responses:
        '200':
          description: 成功响应
          content:
            application/json:
              schema:
                type: object
                properties:
                  version:
                    type: string
                    description: '*API 的当前版本*'
                  version.status_code:
                    type: integer
                    description: >-
                      *常规状态代码*
                      您可以在[此处](https://docs.dataforseo.com/v3/appendix/errors.md)查看完整的响应代码列表。**注意：**我们强烈建议设计必要的系统来处理相关异常或错误情况
                  version.status_message:
                    type: string
                    description: >-
                      *一般信息消息*
                      你可以在[此处](https://docs.dataforseo.com/v3/appendix/errors.md)查看一般信息消息的完整列表
                  version.time:
                    type: string
                    description: '*执行时间（秒）*'
                  version.cost:
                    type: number
                    description: '*任务总成本（美元）*'
                  version.tasks_count:
                    type: integer
                    description: '***`tasks`**数组中的任务数量*'
                  version.tasks_error:
                    type: integer
                    description: '*返回的 **`tasks`** 数组中发生错误的任务数量*'
                  tasks:
                    type: array
                    items:
                      type: string
                    description: '*任务数组*'
                  tasks.id:
                    type: string
                    description: >-
                      我们系统中的*唯一任务标识符*，采用[通用唯一标识符
                      (UUID)](https://en.wikipedia.org/wiki/Universally_unique_identifier)
                      格式
                  tasks.status_code:
                    type: integer
                    description: DataForSEO 生成的*任务状态码*；取值范围为：10000-60000
                  tasks.status_message:
                    type: string
                    description: '*任务信息消息*'
                  tasks.time:
                    type: string
                    description: '*执行时间（秒）*'
                  tasks.cost:
                    type: number
                    description: '*任务成本（美元）*'
                  tasks.result_count:
                    type: integer
                    description: '*`result` 数组中的元素数量*'
                  tasks.path:
                    type: array
                    items:
                      type: string
                    description: '*URL 路径*'
                  tasks.data:
                    type: object
                    description: '*包含与您在 POST 请求中指定的参数相同的参数*'
                  result:
                    type: array
                    items:
                      type: string
                    description: '*结果数组*；在这种情况下，该值将为 `null`'
        '400':
          description: 错误请求
        '401':
          description: 未授权
        '429':
          description: 超出速率限制
        '500':
          description: 内部服务器错误
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````