> ## 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 Ads Keywords Data API 基于最新版本的 [Google Ads API](https://developers.



## OpenAPI

````yaml openapi/zh/dataforseo.json POST /dataforseo/keywords_data/google_ads/keywords_for_keywords/live
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/keywords_data/google_ads/keywords_for_keywords/live:
    post:
      summary: 设置实时“关键词的相关关键词”任务
      description: >-
        请注意，Google Ads Keywords Data API 基于最新版本的 [Google Ads
        API](https://developers.google.com/google-ads/api/docs/start)，该版本已取代旧版
        Google AdWords API。如果您正在使用 [DataForSEO Google AdWords
        API](https://docs.dataforseo.com/v3/keywords_data/google/overview.md)，则需要升级到
        [DataForSEO Google Ads
        API](https://docs.dataforseo.com/v3/keywords_data/google_ads/overview.md)。
      operationId: post_dataforseo_keywords_data_google_ads_keywords_for_keywords_live
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                keywords:
                  type: array
                  items:
                    type: string
                  description: >-
                    keywords，必填字段。最多可以指定 20 个关键词，每个关键词最多包含 80
                    个字符。您指定的关键词将转换为小写格式。注意：Google Ads
                    可能不会返回某些关键词组的数据，请访问我们的帮助中心了解更多信息。另请注意，Google Ads
                    不允许使用某些符号和字符（例如 UTF
                    符号、表情符号），因此设置任务时不能使用它们；有关可用符号和字符的更多信息，请参阅此文章。有关 DataForSEO
                    API 中 keyword 和 keywords 字段的规则与限制，请参阅此帮助中心文章
                location_name:
                  type: string
                  description: >-
                    搜索引擎位置的完整名称 可选字段 如果未指定位置，您将收到全球结果，即所有可用位置的结果；如果使用此字段，则无需指定
                    location_code 或 location_coordinate 可通过向
                    https://api.dataforseo.com/v3/keywords_data/google_ads/locations
                    发出单独请求，获取搜索引擎可用位置及其 location_name 的列表
                    示例：London,England,United Kingdom
                location_code:
                  type: integer
                  description: >-
                    搜索引擎位置代码，可选字段。如果不指定位置，您将收到全球结果，即所有可用位置的结果；如果使用此字段，则无需指定
                    location_name 或 location_coordinate；您可以单独向
                    https://api.dataforseo.com/v3/keywords_data/google_ads/locations
                    发出请求，以获取搜索引擎可用位置及其 location_code 的列表。示例：2840
                location_coordinate:
                  type: string
                  description: >-
                    位置的 GPS 坐标，可选字段。如果不指定位置，您将收到全球结果，即所有可用位置的结果；如果使用此字段，则无需指定
                    location_name 或 location_code；location_coordinate
                    参数应以“latitude,longitude”格式指定；将提供指定坐标所属国家/地区的数据；示例：52.6178549,-155.352142
                language_name:
                  type: string
                  description: >-
                    搜索引擎语言的完整名称 可选字段 可通过向
                    https://api.dataforseo.com/v3/keywords_data/google_ads/languages
                    单独发出请求，获取搜索引擎可用语言及其 language_name 的列表 示例：English
                language_code:
                  type: string
                  description: >-
                    搜索引擎语言代码，可选字段；你可以通过向
                    https://api.dataforseo.com/v3/keywords_data/google_ads/languages
                    单独发起请求，获取搜索引擎可用语言及其 language_code 的列表；示例：en
                search_partners:
                  type: boolean
                  description: >-
                    是否包含 Google 搜索合作伙伴 可选字段 如果指定 true，将返回 Google 自有、运营及联合网络，以及托管
                    Google 搜索的合作伙伴网站的结果；默认值：false – 仅返回 Google 搜索网站的结果
                date_from:
                  type: string
                  description: >-
                    时间范围的开始日期 可选字段 日期格式："yyyy-mm-dd" 最小值：当前日期往前 4 年 默认返回过去 12
                    个月的数据；注意：指定日期不得晚于 date_to 指定的日期和/或昨天；如果 Status 端点在
                    actual_data 字段中返回 false，则 date_from 可设置为上上个月或更早；如果 Status
                    端点在 actual_data 字段中返回 true，则 date_from 可设置为上个月或更早
                date_to:
                  type: string
                  description: >-
                    时间范围的结束日期；可选字段。注意：指定的日期不能晚于昨天；如果不指定此字段，将默认使用昨天的日期。日期格式："yyyy-mm-dd"；示例："2022-11-30"。
                sort_by:
                  type: string
                  description: >-
                    结果排序参数，可选字段。使用这些参数按
                    relevance、search_volume、competition_index、low_top_of_page_bid
                    或 high_top_of_page_bid 对结果进行降序排序；默认值：relevance
                include_adult_keywords:
                  type: boolean
                  description: >-
                    包含与成人内容相关的关键词，可选字段。如果设置为 true，响应中将包含成人关键词，默认值：false。请注意，由于
                    Google Ads 的限制，API 可能不会返回此类关键词的数据
                tag:
                  type: string
                  description: >-
                    用户定义的任务标识符。可选字段。字符数限制为 255。您可以使用此参数标识任务并将其与结果匹配；您将在响应的 data
                    对象中找到指定的 tag 值
              required:
                - keywords
      responses:
        '200':
          description: 成功响应
          content:
            application/json:
              schema:
                type: object
        '400':
          description: 错误请求
        '401':
          description: 未授权
        '429':
          description: 超出速率限制
        '500':
          description: 内部服务器错误
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````