本地生活服务广告系列
本地生活服务广告系列 本地生活服务广告系列 让您可以在 Google 上宣传 您的商家信息，直接从潜在客户那里获得他们的相关信息。 本指南总结了当前版本的 Google Ads API 中支持的操作和限制。 支持的操作 支持以下操作。 检索本地生活服务广告系列和预算 您可以使用 GoogleAdsService.Search 或 GoogleAdsServi
完整资料目录
共 1986 份资料 · 第 4 / 20 页
广告系列
广告系列 Google Ads 广告系列 由一个或多个广告组（包含广告、关键字和出价）组成，这些广告组共享预算、地理位置定位和其他设置。 广告系列通常用于将广告客户提供的产品或服务按类别组织起来。广告系列是 Google Ads 账号中的顶级组织工具。 您可以在广告系列一级设置的项目包括出价、预算、语言、地理位置、在 Google 广告网络中的投放范围等等。
搜索广告系列使用入门
搜索广告系列使用入门 借助 搜索广告系列 ，您可以在 Google 搜索结果页和 Google 合作伙伴网站上展示文字广告。借助 Google Ads API，您可以以编程方式创建、管理和优化这些广告系列。 如果您想吸引正在积极搜索与您的业务相关的特定关键字的用户，那么搜索广告系列是理想之选。 本指南将引导您完成制作首个搜索广告系列所需的所有步骤。 前提条件
更改事件
更改活动 “更改事件” 会详细列出账号中的更改。在报告创建操作时，系统会返回所有新的字段值；在报告更新操作时，系统会返回新值和旧值，让您全面了解各个更改。 此外，系统还会显示用于进行更改的 客户端类型 （例如 API 或 Web 客户端），以及进行更改的用户（假设该信息也显示在 Web 客户端的“更改历史记录”中）。 更改活动类型 请参阅 ChangeEve
更改状态
更改状态 ondemand_video 视频：状态 ChangeStatus 提供了一种跟踪特定时间段内账号中哪些资源发生了更改的方法。如果资源在您指定的时间段内发生了多次更改，则系统只会返回最近一次更改。然后，您可以确定是否需要将本地数据库值与该时间段内发生更改的值同步。 例如，如果您在指定的时间段内添加了某个广告系列，然后又更新了该广告系列，则系统只会返
账号类型
Google Ads API 中的账号类型 本文档介绍了 Google Ads API 中用于描述账号的不同术语，以及它们之间的关系。 概览 Google Ads API 使用多个术语来描述账号，这有时可能会导致混淆。了解这些区别对于管理账号和解读 API 响应非常重要。 账号类型 以下定义阐明了在使用 Google Ads API 时会遇到的不同账号类型。
API 结构
API 结构 ondemand_video 视频：观看 2019 年研讨会上的“服务和资源”讲座 本指南介绍了 Google Ads API 的主要构成组件。Google Ads API 由多个资源和服务组成。 资源表示 Google Ads 实体，而服务用于检索和处理 Google Ads 实体。 对象层次结构 Google Ads 账号可以视为一个对象层
通话结构
API 调用结构 本指南介绍了所有 API 调用的常见结构。 如果您使用客户端库与 API 进行互动，则无需了解底层请求的详细信息。不过，在进行测试和调试时，了解一些 API 调用结构还是很有用的。 Google Ads API 是一个带有 REST 绑定的 gRPC API 。这意味着，您可以通过两种方式调用该 API。 首选 ： 将请求正文创建为 协议缓
更改对象
更改对象 目标 ： 了解如何使用 Google Ads API 修改对象。 正如 API 结构指南 中所述，Google Ads API 中的每个顶级资源都有相应的特定于资源类型的服务，且该服务支持修改资源实例。 本指南将使用 CampaignService 来演示如何修改 Campaign 对象，但同样的概念也适用于所有其他特定于资源类型的服务。 关键术语
资源元数据
资源元数据 您可以使用 GoogleAdsFieldService 动态请求以下内容的目录：资源、资源的字段、细分键和指标，它们均位于 GoogleAdsService Search 和 SearchStream 方法中。该目录提供了各种元数据，可供 Google Ads API 客户端用于验证和构建 Google Ads 查询语言语句。 示例 HTTP 请
云端管理的访问权限级别
云端管理的访问权限级别 注意 ： Google 正在接受此计划的申请。 立即注册 。 借助此功能，您可以让 Google Cloud 组织 管理您的 API 访问权限级别，从而获得以下优势： 无需再保护开发者令牌 ：API 访问权限通过 Google Cloud 组织进行管理，因此您无需再担心保护开发者令牌或泄露开发者令牌。您可以在 API 调用中跳过发送开
API 概览
API 概览 注意 ：本指南适用于已熟悉 Google Ads 的用户。 其他人可能需要先查看 关于帐号组织的帮助中心文章 ，了解帐号的主要组成部分及其组织方式。如需了解详情，也可参阅 Google Ads 基础知识系列 这项实用资源。 本系列指南概述了 Google Ads API 中提供的对象、方法和服务。阅读这些指南后，您将了解以下关键概念： Goog
检索对象
检索对象 目标 ： 了解如何使用 GoogleAdsService 检索对象和效果统计信息。如需了解报告概念，请参阅 报告指南 。 GoogleAdsService 是 Google Ads API 的统一对象检索和报告服务。该服务具有以下方法： 检索对象的特定属性。 根据日期范围检索对象的效果指标。 根据对象的属性对对象进行排序。 使用条件指示要在响应中返
版本控制
版本控制 目标 ： 了解 Google Ads API 版本控制的运作方式。 语义版本控制 Google Ads API 遵循 语义版本控制 ，其中包含主要版本和次要版本。版本格式为 MAJOR.MINOR 或 vMAJOR_MINOR 。例如， v24_0 是主要版本，而 v24_1 是次要版本。 如需查看过往版本的版本说明，请参阅 版本说明 。 主要版本
转化操作类别
转化操作类别 本指南列出了您可以使用 Google Ads API 创建的不同类型的转化操作，并介绍了这些转化操作与 Google Ads 网页界面的对应关系。 选择合适的转化操作类型 为了帮助您为集成选择正确的转化操作类型和设置指南，请使用以下决策路径： 转化事件发生在何处？ 在线下 （例如在您的办公室、营业地点或通过电话）：请前往 第 2 步 。 直接在
自定义转化变量
自定义转化变量 借助 自定义转化变量 ，您可以将其他信息（以代码的形式）与使用 Google Ads API 导入的转化（例如点击转化或来电转化）相关联。有了这些信息，您就可以创建细分报告，其中包含更丰富的转化数据。 例如，在导入购买新蓝色帽子这一转化时，您还可以同时导入两个相关联的标记： color 和 status ，它们的值分别为 blue 和 new
转化价值规则
转化价值规则 借助 转化价值规则 ，您可以定义根据 ConversionAction 的类别和展示的以下维度修改转化价值的操作： 受众群体成员资格 实际所处位置或感兴趣的地理位置 设备 旅游行程 您可以使用 Google Ads API 定义转化价值规则，将这些规则组合成转化价值规则集，然后将该规则集应用于整个 Google Ads 账号或特定广告系列。Go
开始使用转化
使用入门 您必须在 Google Ads 转化账号中启用转化跟踪，才能记录转化。本指南详细介绍了如何确认是否已启用转化跟踪，如果尚未启用，则如何启用转化跟踪，以及如何检索有关现有转化操作的信息。 对于大多数转化操作，您还需要执行额外的操作才能进行跟踪。如需详细了解各种转化操作类型及其 要求，请参阅 创建转化操作指南 。 准备提供用户意见征求 您必须确认自己有
广告系列目标
广告系列目标 广告系列目标 让您可以 针对特定转化 操作优化特定广告系列。如果您的广告系列的目标与账号级 目标不同，您可以根据需要修改每个 CampaignConversionGoal 及其 biddable 设置。例如，如果您的账号通常针对电子商务进行优化，但您有一个广告系列以商店访问为目标，则可以为所有 CampaignConversionGoal 对象
客户目标
客户目标 每个 CustomerConversionGoal 都会确定您是否希望 Google Ads 针对具有 指定 category 和 origin 的转化操作进行优化。当您向账号的 Google Ads 转化 客户 添加 ConversionActions 时，Google Ads 会自动创建 CustomerConversionGoals ，以 确
生命周期目标
生命周期目标 使用 Google Ads API 的 CustomerLifecycleGoal 和 CampaignLifecycleGoal 资源来配置与客户生命周期相关的目标。Google Ads API 支持 客户获取目标 ，可帮助您通过 Google Ads 搜索广告系列、购物广告系列和效果最大化广告系列高效获取新客户。 如果您的 Google A
转化目标
转化目标 转化目标 可帮助您整理转化操作，以便您更轻松地针对广告目标进行优化。 转化目标会按您账号的 Google Ads 转化客户 中的 ConversionActions 集合中的 category （例如 PAGE_VIEW ）和 origin （例如 WEBSITE ）的唯一组合进行分组。 重要提示 ： 在 Google Ads 界面的目标管理标签页
转化管理
转化管理 在 Google Ads 中， 转化 是指用户在点击广告或看到展示广告网络广告后执行了某项指定的操作。转化是指对实现广告目标至关重要的客户互动，例如购买产品、安装移动应用或注册电子邮件收件人列表。 转化跟踪 功能可以提供重要的洞察信息，供您了解用户在浏览或点击广告后所执行的操作。您可以跟踪执行下列操作的用户，例如致电、购买产品和安装移动应用等。 借
转化报告 · 转化管理
转化报告 您可以通过检索有关特定转化操作的数据，或检索其他资源（例如广告系列、广告组和广告）的转化指标，在 Google Ads API 中生成转化报告。本指南介绍了如何检索该信息，以及 Google Ads 界面指标如何映射到 Google Ads API 指标 。 检索有关特定转化操作的数据 您可以使用 conversion_action 资源检索现有转
问题排查
问题排查 管理转化需要复杂的集成，通常涉及多个相互依赖的工具和流程。本指南详细介绍了您可以采取哪些步骤来排查遇到的任何问题，无论您是遇到不了解的 API 错误，还是对界面中看到的指标或诊断信息感到困惑，都可以参考本指南。 重要提示 ： API 返回的成功导入响应并不一定意味着转化已归因。如需详细了解成功导入后出现的数据差异，请参阅 这篇帮助中心文章 。 在
上传转化调整数据
导入转化调整数据 向 Google Ads 报告转化后，您可以在 Google Ads API 中稍后 调整转化 。 若要调整转化，您必须先 设置转化操作 ，并且还必须记录您即将调整的转化。 警告 ： 转化调整不适用于类型为 UNKNOWN 的转化操作。 转化调整适用于 GCLID 和 GBRAID，但不适用于 WBRAID。 代码示例 Google Ads
管理来电转化
导入来电转化数据 您可以使用 Google Ads API 将 线下来电 转化 导入 Google Ads ，以便跟踪广告何时促成来电，以及这些来电何时促成有价值的客户操作。 在 Google Ads 界面中，这与先使用 上传 转化来源，然后选择 来电转化 相同。 重要提示 ： 如需有关启用转化跟踪（这是导入转化的 前提条件）的完整说明，请参阅 入门 指南
管理线下转化
管理线下转化 警告 ： 自 2026 年 6 月 15 日 起，如果开发者令牌之前未发送过用于上传线下转化数据或增强型潜在客户转化数据的请求，则 UploadClickConversion 请求将会失败。请改用 Data Manager API ；如需了解详情，请参阅 功能弃用 。 您可以使用 Google Ads API 将线下转化数据导入 Google
管理线上转化
管理在线点击转化 您可以使用 Google Ads API 在 Google Ads 中管理在线点击转化。在线点击转化有助于您跟踪在网络世界中促成销售的广告，例如通过网站促成销售的广告。 在线转化是使用 Google 代码 进行跟踪的，但您可以使用 Google Ads API 对其进行调整 或增强。 如果您已设置 Google 代码并想要调整在线 转化，请
管理实体店销售转化
导入实体店销售转化数据 重要提示 ：此功能仅适用于已加入允许名单的账号。如果您需要使用此功能，请与您的 Google 代表联系。 Google Ads API 支持导入 实体店销售 转化 ，让您可以 自行或通过第三方 合作伙伴直接将线下交易数据导入 Google Ads。通过匹配销售终端系统或客户数据库中的交易数据，您可以了解广告在促成线下购买方面的效果。
监控上传健康状况
监控离线数据诊断信息 注意 ： 对于增强型潜在客户转化数据导入，请使用 Google Ads 界面中的 增强型潜在客户转化诊断报告 来监控导入的健康状况。 使用 Google Ads API 检索 线下数据诊断信息 ，其中包含有关转化数据导入和调整流程总体运行状况的信息。 如需检索账号的最新线下数据诊断信息，请使用以下资源之一： offline_conver
受众群体定位
受众群体定位 需求开发广告系列中的受众群体定位具有其他广告系列类型不支持的一些独特功能。 一种是 相似细分受众群 ，您可以使用它来定位与他人相似且具有共同特征的受众群体。 如需详细了解相似细分受众群，请参阅有关如何 “使用相似细分受众群来扩大受众群体” 的帮助中心文章。 此外，您还可以使用 AdGroupCriterion 在广告组一级 设置受众群体定位。
渠道控制选项
渠道控制选项 借助需求开发广告系列中的 渠道控制选项 ，您可以在 YouTube、Gmail、Google 探索以及 Google 展示广告网络等以视觉效果为先的各个 Google 展示途径中，选择广告的展示渠道。 例如，您可以量身定制专门在 YouTube Shorts 上投放的需求开发广告系列。 您可以使用 demand_gen_ad_group_set
制作广告系列
制作需求开发广告系列 检查是否满足 最低要求 。需求开发广告系列的素材资源必须达到很高的质量标准，因为它们会在 Google 探索和 YouTube 等视觉化、以娱乐为中心的平台上投放。 如需制作需求开发广告系列，请执行以下操作： 创建预算。 使用适当的出价策略制作需求开发广告系列。 制作不含类型的广告组。 创建受众群体。 制作素材资源和需求开发广告。 我们
需求开发
需求开发 借助 需求开发广告系列 ，您可以在 Google 最具沉浸感的视觉平台（包括 YouTube [含 Shorts]、Google 探索、Gmail 和 Google 地图）上与用户分享品牌故事。这种广告系列可在多个不同的接触点覆盖客户，并利用 Google AI 技术向最相关的潜在客户投放最佳广告素材，以及优化整个漏斗中的出价，同时允许广告客户完全
采用产品 Feed 的广告系列
使用产品 Feed 的需求开发广告系列 您可以使用 Google Merchant Center (GMC) 商品 Feed 在需求开发广告系列中制作商品广告。 为此，您需要执行以下步骤： 将 Google Merchant Center 账号与需求开发广告系列相关联 创建广告组以及一种或多种受支持的广告类型 使用 ListingGroup 条件来限制 Fe
报告与优化
生成报表和优化 需求开发广告系列的报告信息可以像其他广告系列类型一样，在不同层级进行检索。 广告系列级报告 与其他广告系列类型一样，您可以使用 GoogleAdsService.SearchStream 检索需求开发广告系列的属性和效果指标。 SELECT campaign . id , campaign . status , campaign . bidd
安装和使用 Google Ads API 开发者助理
安装和使用 Google Ads API 开发者助理 注意 ：此工具是一个开源项目，并非 Google 官方产品。 前提条件 在开始之前，请确保满足以下条件： Google Ads API 访问权限 ： Google Ads API 开发者令牌 。 包含您的开发者令牌、OAuth 2.0 凭据和客户 ID 的 Google Ads 配置文件 ，位于您的主目录
Google Ads API Explorer
Google Ads API Explorer Google Ads API Explorer 是一种交互式执行环境，可让您直接通过浏览器构建和发送实时 API 请求。它嵌入在参考文档中，可处理 OAuth 2.0 身份验证和 JSON 载荷格式设置的复杂性，让您无需编写任何代码即可测试特定服务和方法。 福利 无代码测试 ： 直接通过文档执行实时 API 调
Google Ads 查询构建器
Google Ads 查询构建器 Google Ads 查询构建器是一款互动式工具，旨在帮助您使用 Google Ads 查询语言 (GAQL) 以互动方式构建和验证查询。无论您是 GAQL 新手还是经验丰富的用户，查询构建器都可以简化从 Google Ads API 中提取所需确切数据的过程。 福利 易用性 ： 简化了编写 GAQL 查询的过程，无需熟悉特
Google Ads 查询验证器
Google Ads 查询验证器 Google Ads 查询验证工具是一款交互式工具，旨在帮助开发者在将 Google Ads 查询语言 (GAQL) 查询集成到应用之前先构建并验证这些查询。借助该工具，您可以输入 GAQL 查询字符串，并立即获得有关其有效性的反馈，从而在开发过程的早期发现语法错误、字段不兼容性问题和其他问题。 优势 防止出错 ：在无效查询
Google Ads MCP 服务器
Google Ads MCP 服务器：开发者集成指南 Model Context Protocol (MCP) 是一种开放标准，可让大语言模型 (LLM) 安全地与外部数据和应用互动。 Google Ads MCP 服务器 提供了一个通往 Google Ads API 的标准化桥梁，让 AI 代理可以使用自然语言分析和检索广告系列数据。 社区资源和支持 Gi
什么是 Google Ads API 开发者助理？
什么是 Google Ads API 开发者助理？ Google Ads API 开发者助理不是聊天机器人，而是基于 Google Antigravity 智能体框架 (v3.0.0) 构建的 Gemini 赋能型广告工程任务控制系统。 全局概览：解决高合规性摩擦问题 此助理解决的根本问题是认知过载和技术苦差事。 Google Ads API 是功能最强大但
制作上传的展示广告
制作上传的展示广告 以下示例展示了如何创建基本的上传的展示广告： Java // Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in comp
上传的 HTML5 广告
上传的 HTML5 广告 若要制作已上传的 HTML5 广告，您必须 满足 下列要求之一： 广告 媒体包 使用 AMPHTML 而非传统 HTML。 该帐号的支出金额已超过 9000 美元，且开设时间已超过 90 天。 该帐号已列入此功能的许可名单。您可以填写 此表单 以申请列入许可名单。 上一页 arrow_back 制作上传的展示广告
上传的展示广告
上传的展示广告 借助 上传的展示广告 ，您可以上传自己的图片，以在 Google 展示广告网络 中展示。 上传的展示广告中使用的广告素材有特定要求。 如需了解详情，请参阅 上传的展示广告的规范 。 下一页 制作上传的展示广告 arrow_forward
基于素材资源的动态再营销
使用素材资源进行动态再营销 借助动态再营销，您的广告系列可以投放根据用户过往行为量身定制的广告。当用户被添加到动态再营销名单时，跟踪像素中还会提供素材资源的 ID。当列表中的用户看到广告时，系统会根据底层 AssetSet 动态呈现广告内容。 本文档介绍了如何管理包含动态内容素材资源的动态再营销广告系列。 制作可在动态再营销广告系列中投放的素材资源 您可以使
基于 Merchant Center 的动态再营销
示例：使用 Google Merchant Center 制作动态再营销广告系列 在此示例中，您有一个零售网站，该网站会将商品详情上传到 Google Merchant Center，并且您希望向访问过该零售网站的用户再营销一组商品。这些用户可能访问过产品页面，或将商品放入购物车或结账，而这些行为会触发再营销标记。然后，您可以制作一个广告系列，仅定位此群组，
动态再营销
动态再营销 动态再营销 广告是根据每次展示机会量身定制的展示广告，可展示与用户之前访问过的网站相关的内容。 动态再营销具有诸多优势，包括： 可扩展性 ：结合使用 Feed 后，您可以制作可根据产品或服务调整规模的广告。 简单而强大的素材资源 ：创建 Feed 后，Google Ads 商品推荐引擎会提取产品和服务，根据热门程度和访问者在您网站上浏览过的内容来
前提条件
前提条件 请遵循以下前提条件来实施动态再营销。 添加 Google 代码和再营销事件代码段 首先， 为网站添加再营销代码 。 您可以使用 conversion_action 字段的 TagSnippet 从 API 中检索 googleGlobalSiteTag 或 event_snippet 。 以下是手动在网站中嵌入代码的步骤： 获取 Google 代码
创建动态搜索广告
制作动态搜索广告 如需使用 Google Ads API 设置动态搜索广告 (DSA)，请按以下步骤操作： 制作广告系列并指定其网域。 为与动态搜索广告相关的功能制作广告组。 制作一个或多个动态搜索广告。 在广告系列中指定展示动态搜索广告的一个或多个条件。 制作广告系列 如需告知 Google Ads 您将在广告系列中使用动态搜索广告，您 首先需要制作一个
DSA page feeds
动态搜索广告页面 Feed 默认情况下，动态搜索广告 (DSA) 会定位到整个网站或网站的某些部分，而不会专注于特定网页网址。如果您需要更好地控制网址，可以使用 DSA 页面 Feed 来精确指定要在 DSA 中使用哪些网址。如果您提供产品及其着陆页的页面 Feed，将有助于 Google Ads 确定何时展示您的广告以及将用户引导至您网站上的什么位置。 本
动态搜索广告
动态搜索广告 提示 ： 已经在使用动态搜索广告了吗？ 了解升级为效果最大化广告系列的好处。 动态搜索广告 (DSA) 借助动态搜索广告 (DSA)，您可以定位整个网站或网站的某些部分，而无需为所有可能的匹配项创建关键字和广告。相反，每当用户进行相关搜索时，系统都会动态生成广告，其中广告标题根据具体的查询生成，广告文字根据您网站上与搜索内容最相关的着陆页生成。
报告 · 动态搜索广告
报告 dynamic_search_ads_search_term_view 资源提供 基于搜索字词的动态搜索广告 (DSA) 统计信息 。 search_term 字段包含生成了结果的任何匹配查询。 在以下示例中，GAQL 查询会检索上个月的效果数据： SELECT dynamic_search_ads_search_term_view . search_
素材资源优化实验
素材资源优化实验 素材资源优化实验用于测试效果最大化广告系列中的不同素材资源组合，以便您比较不同素材资源组与基准组的效果。 此工作流适用于 ExperimentType.OPTIMIZE_ASSETS 。 设置 如需设置素材资源优化实验，请执行以下操作： 创建新素材资源，即包含对照组和实验组的实验。 将新素材资源与实验组的素材资源组相关联 - 所有操作都在单
异步错误
异步错误 由于 ExperimentService 包含一些异步操作，因此获取与这些操作相关的错误的机制不同于其他同步操作。 使用此错误报告机制的异步操作包括： ExperimentService.ScheduleExperiment ExperimentService.PromoteExperiment 对于这些方法，API 会返回一个 长时间运行的操作
广告系列组合实验
广告系列组合实验 重要提示 ：此功能仅适用于已加入允许名单的账号。如果您需要使用此功能，请与您的 Google 代表联系。 广告系列组合实验适用于复杂的测试场景，涉及比较一个或多个广告系列中的多个变量（最多支持 5 个实验组）。此工作流支持在同一实验中混合使用多种广告系列类型。 此工作流支持以下 ExperimentType 值： COMPARE_CAMPA
广告系列内实验
广告系列内实验 广告系列内实验用于在单个广告系列内测试特定功能。 与系统管理的实验（在 对照组和实验组 广告系列 之间分配流量）不同，广告系列内实验会在广告系列内分配流量 具体取决于相应功能是否已启用 。 以下 ExperimentType 值支持此工作流： ADOPT_AI_MAX 测试 AI Max 功能对搜索广告系列的影响。 ADOPT_BROAD_M
实验概览
实验概览 Google Ads API 提供了相关资源，可用于针对广告系列、关键字、出价策略等测试新想法。根据您要测试的内容，有多种不同的工作流程可供选择。 所有实验工作流程都涉及在 对照 组或广告系列与应用了更改的一个或多个 实验 组或广告系列之间拆分流量。通过比较对照组和实验组的效果指标，您可以评估更改的效果。 实验工作流 Google Ads API
实验报告 · 实验概览
实验报告 报告实验结果主要有两种方式： 直接实验报告 ：查询 experiment 资源以获取指标。此选项会在单个响应中提供对照组和实验组的指标，以及提升和 p 值等统计比较数据。这是报告 广告系列内 实验的唯一方式。 广告系列报告 ：查询 campaign 资源 以获取指标，并使用 campaign.experiment_type 区分基准 广告系列和实验
由系统管理的实验
由系统管理的实验 系统管理的实验用于通过创建与原始对照组广告系列一起投放的一个或多个可修改的实验组广告系列来对更改进行 A/B 测试。此工作流支持以下 ExperimentType 值： SEARCH_CUSTOM ：包含搜索广告系列的自定义实验。 DISPLAY_CUSTOM ：包含展示广告系列的自定义实验。 HOTEL_CUSTOM ：包含酒店广告系列的
常见错误
常见错误 本文列出了常见错误，并提供了有关如何避免和处理这些错误的提示。 如需查看完整的错误列表，请参阅 错误参考 。如需更多支持，请访问我们的 论坛 。 google.rpc.ErrorInfo ACCESS_TOKEN_SCOPE_INSUFFICIENT 摘要 OAuth 2.0 访问令牌不具备必需的范围。 常见原因 请求被拒绝，因为所提供的访问令牌不
处理错误
处理 API 错误 当您向 Google Ads API 发送请求时，请求可能会因各种原因而失败。例如，您可能会提供无效的实参，或者您的账号可能已达到创建新广告系列的上限。在这种情况下，API 会返回错误，让您了解出了什么问题。 本指南介绍了如何读取和处理 API 错误，以便您构建更强大的应用。 错误结构 如果您使用的是我们的某个 客户端库 ，API 错误
简介 · 开始使用
简介 Google Ads API 是 Google Ads 的程序化接口，用于管理大型或复杂的 Google Ads 账号和广告系列。您可以构建软件，全方位管理从客户一级到关键字一级的账号。一些典型用例包括： 自动账号管理 自定义报告 基于产品目录的广告管理 智能出价策略管理 Google Ads API 是否适合我？ Google 提供了多种产品来帮助您
快速入门
快速入门 本快速入门指南可帮助您首次调用 Google Ads API。 主要概念 开发者令牌 ：开发者令牌是由 22 个字符组成的字母数字 字符串，用于向 Google Ads API 服务器标识您的应用。进行 API 调用时，必须提供此令牌。 **API 访问权限级别** ：开发者令牌的 API 访问权限级别控制着您每天可以进行的 API 调用次数以及
后续步骤
后续步骤 您已使用 Google Ads API 成功进行 API 调用，接下来可以参考以下实用资源，继续探索 Google Ads API。 API 基础知识 API 授权和访问权限模型 如何提问和获取帮助 使用 Google Ads API 开发者助理 高枕无忧地进行实验 您可以使用 Google Ads API 进行实验，而无需修改生产环境中的 Goo
分配策略
指定或更新出价策略 对于酒店广告，您可以为单个广告系列分配出价策略。 **要点：** 对于“百分比形式的每次点击费用”和“每次点击费用人工出价”策略，您需要在广告系列一级分配 这些策略，但在广告组一级设置出价金额。 如需详细了解如何为酒店广告选择出价策略，请参阅 酒店广告出价概览 。 熟悉出价策略后，您可以使用 Google Ads API 分配和更新酒店广
调整出价
使用出价调节系数调整出价 您可以使用 Google Ads API 为酒店广告设置出价调整（也称为出价调节系数）。如需详细了解您可以设置的出价调整，请参阅 酒店广告的出价调整简介 。 广告系列级出价调整 如需使用 Google Ads API 在广告系列一级设置出价调整，请参阅 管理出价调节系数 。 广告组级出价调整 如需使用 Google Ads API
出价
出价 熟悉 酒店广告出价概览 后，您可以使用 Google Ads API 执行以下操作： 在广告系列一级 分配或更新出价策略 设置或更新出价金额 设置出价调整（出价调节系数） 上一页 arrow_back 创建商品详情组 下一页 分配策略 arrow_forward
设置出价
设置或更新出价 您可以使用 Google Ads API 为酒店广告设置或更新出价。 注意 ： 所有非零出价（包括出价调整）都符合酒店 宣传广告的条件（只要 AdGroup.type = PROMOTED_HOTEL_ADS )。 请勿设置 bidding_strategy 或 bidding_strategy_type 字段。 bidding_strate
制作广告
制作酒店广告组广告 制作酒店广告包含以下两个步骤： 创建 Ad 并将其 hotel_ad 设置为 HotelAdInfo 的实例。 创建 AdGroupAd 并将之前创建的 Ad 与其关联。 要点 ： 如需为广告组投放酒店广告，您需要一个 AdGroupAd ，其 ad 已设置且 status 为 ENABLED （您可以使用 查询 来检查这些值）。 您可以
制作广告组
创建酒店广告组 要为您的酒店广告系列投放广告，您必须创建一个 AdGroup ，且该广告组中至少包含一个广告。如下所示 ，酒店广告系列仅支持 HOTEL_ADS 类型的广告组 ，您可以在 type 字段中对此进行设置。由于广告系列的出价策略为 PercentCpc ， 该代码示例还设置了“百分比形式的每次点击费用”出价。 Java private Strin
制作广告系列
制作酒店广告系列 植入酒店广告的第一步是制作酒店广告系列。在制作酒店广告系列时，您需要设置其预算、出价策略和 Hotel Ads Center 账号 ID。 设置酒店广告系列的具体步骤如下： 将广告系列的 advertising_channel_type 设置为 HOTEL 。 创建 HotelSettingInfo ，设置其 hotel_center_id
创建商品详情组
创建酒店信息组 ondemand_video 视频：观看 2019 年研讨会上的“信息组”主题演讲 通过酒店广告组，您可以将自己的酒店按照多个维度划分为多个酒店信息组，这样就可以相应地调整每个组的出价。 分组时，请考虑使用这样的树状结构：在第一级，将酒店大致划分为五星级酒店、四星级酒店和其他星级酒店； 然后在第二级，将其他星级的酒店划分为“美国”酒店、“英国
酒店广告
酒店广告 重要提示 ：此功能仅适用于列入许可名单的帐号。如果您需要访问该功能，请与您的 Google 代表联系。 提示 ： 不妨了解一下 指定旅行目标的效果最大化广告系列 ，这是一种效果最大化广告系列，可让您针对各个 Google 渠道中的酒店房源制作广告。与酒店广告不同，此功能面向所有用户提供。 酒店广告是系统根据您提供的酒店信息和价格自动制作的一种广告。
报告 · 酒店广告
报告 ondemand_video 视频：观看 2019 年研讨会上的酒店广告报告讲座 借助 Google Ads API，您可以设计查询来获取所需的酒店广告报告。 然后，您可以将这些查询整合到客户端应用中。 前提条件 了解 报告 和 查询 的一般工作原理。 了解如何查询不同的 资源 。 酒店广告的基本查询 查看以下示例查询，熟悉如何使用 Google Ad
搜索广告的旅游 Feed
搜索广告中的旅游 Feed 将酒店、民宿或推荐活动商品 Feed 与 Google Ads 账号相关联后，Google Ads 现在会自动从您的 Feed 中提取价格和图片，以丰富现有搜索广告系列。此功能称为 搜索广告中的旅游 Feed 。 注意 ： 在客户或广告系列一级关联垂直行业数据 Feed 后，如果启用了 AI Max，您的广告系列还可以使用垂直行业
受众群体分析
受众群体分析 重要提示 ： 此功能仅适用于已加入许可名单的账号。如果您需要使用此功能，请与您的 Google 代表联系。 对 AudienceInsightsService 的所有请求都会受到速率限制。不过，与受众群体洞察的其他方法相比， generateAudienceCompositionInsights 和 generateSuggestedTarge
YouTube 创作者数据分析
YouTube 创作者数据分析 注意 ： 此功能目前处于 Beta 版阶段，仅供许可清单中的开发者使用。 借助创作者数据分析功能，您可以发现并获取有关 YouTube 创作者的数据分析。对于想要寻找与目标受众群体相关的创作者的代理机构和广告客户来说，此功能非常实用。 该 API 具有四项主要功能： 创作者发现 ：根据给定的一组主题、受众特征、受众群体或创作者
分析洞见
分析洞见 您可以通过多种类型的数据洞见来发现市场中的趋势和了解广告效果。您可以： 检索为您的业务量身提供的数据洞见 了解表现 采取建议措施 Google Ads API 不支持 Google Ads 界面 中的所有数据分析。您可以使用 生成以下 API： 受众群体分析 YouTube 创作者数据分析 搜索字词数据分析 下一页 受众群体分析 arrow_for
生成广告组主题
广告组主题 使用 KeywordPlanIdeaService ，您可以生成与现有关键字和广告组具有相同主题的关键字。 例如，如果主题是 bakery ，系统会生成旨在针对 bakery near me 、 local bakery 或 cake shop 等搜索触发广告的关键字。 关键字整理建议 使用 KeywordPlanIdeaService.Gene
生成预测指标
生成预测指标 预测指标 可为提议的广告系列或现有广告系列提供指标，包括： 展示次数 点击率 平均每次点击费用 Clicks 费用 尝试不同的广告系列配置，以优化上述各项指标。预测中可能会使用历史质量得分和点击率等数据来模拟预期效果，例如转化率。 预测指标通常在 历史指标 之后使用。 历史指标可将庞大的关键字列表缩减为更易于管理的规模。 预测指标可更准确地估算
生成历史指标
生成历史指标 历史指标 提供 有关关键字在 Google 搜索上的历史效果的指标，包括： 平均每月搜索量（过去 12 个月） 每月大致搜索量（每月） 竞争程度 竞争指数 出价的第 20 个百分位 出价的第 80 个百分位 您可以使用历史指标，根据效果将大量关键字缩减为更易于管理的大小。如果您已经知道要使用的关键字 ，则可以跳过历史指标，直接查看 预测指标 。
生成关键字提示
关键字提示 借助 KeywordPlanIdeaService ，您可以搜索与 Google 搜索广告系列相关的新关键字，或查找关键字的历史指标。 生成创意 使用 KeywordPlanIdeaService.GenerateKeywordIdeas 为广告系列生成关键字提示。 您可以提供关键字和网址种子来生成提示。设置地理位置、语言和投放网络设置等定位参数
关键字规划
关键字规划 重要提示 ：向关键字规划服务发出的所有请求（包括标准访问权限和基本访问权限）都有速率限制。与其他服务相比，每分钟允许的 请求更少 。 我们建议您缓存或存储结果，因为您在很长一段时间内确实会收到相同的响应。例如，如果您请求一组现有关键字，响应在几小时或几天内不会发生变化。如果是历史指标，统计信息每月刷新一次。 关键字规划是一个流程，用于 获取关键字
Mutate 最佳做法 · 转变资源
Mutate 最佳做法 临时资源名称 GoogleAdsService.Mutate 支持使用临时资源名称，以便稍后在同一个请求中进行引用。这样，您就可以在一个请求中（例如）制作广告系列及其关联的广告组、广告、关键字等。 为此，您可以指定新资源的 resource_name 使用负 ID。例如，假设您制作了一个广告系列，并将其资源名称 指定为 custome
批量转变
批量转变 如果您需要同时对不同类型的实体执行操作，或者希望对单个端点进行写操作，而不愿每种资源类型使用单独的端点，则可以将 GoogleAdsService.Mutate 端点用于所有受支持的 mutate 操作。 注意 ： 您可以在 MutateOperation 的参考页面上查看支持的操作的完整列表。 Mutate 操作 每个 MutateGoogleA
转变资源
转变资源 Google Ads API 提供了几种不同的资源转变方式，具体取决于您的用例。每个资源都有对应的服务，可让您为特定资源类型指定转变操作。例如， Campaign 资源具有对应的 CampaignService.MutateCampaigns 端点，用于转变广告系列。 另一种选择是 GoogleAdsService.Mutate 端点，该端点实际上
资源转变
资源服务转变 使用资源的单个服务是最直接的转变方式，但也是最不灵活的。 Mutate 端点 使用特定于资源的服务是最直接的转变方式。每种可变资源都对应一种服务以及一组可让您创建、更新或移除资源的操作。 假设您要制作一个新的 Campaign 。 您可以先创建一个新的 Campaign 对象，再将其置于 CampaignOperation 中，然后将其发送到
访问模型概览
了解 Google Ads 访问权限模型 Google Ads 账号有两种类型： Google Ads 经理账号 和 Google Ads 广告客户账号 。如需详细了解这些术语以及其他术语（例如“客户账号”和“客户”）之间的关系，请参阅 账号类型 。 经理账号可以管理其他 Google Ads 经理账号或 Google Ads 广告客户账号。您可以 将广告客
设置 Google API 控制台项目以进行授权
设置 Google API 控制台项目 创建和配置 Google API 控制台项目时要遵循的步骤取决于您要在应用中构建的 OAuth 2.0 授权方案的类型。选择您要构建的授权方案；本指南将根据您的选择进行自定义。 服务账号 用户身份验证 您需要一个 Google API 控制台项目，才能创建 OAuth 2.0 凭据并为您的应用启用 Google Ads
凭据管理
凭据管理 下表总结了应用应管理的凭据列表。如需了解各种应用类型，请参阅我们的 OAuth 文档 。 身份验证工作流 凭据 凭据类型 用途 所有应用类型 开发者令牌 应用凭据 允许您使用具有 已获批访问权限级别 的 Google Ads API。 JavaScript Web 应用 Android 应用 OAuth 客户端 ID 应用凭据 在执行 OAuth
OAuth 2.0 内部结构
适用于 Google Ads API 的 OAuth 2.0 内部结构 注意 ： 我们的客户端库会自动处理本指南中涉及的详细信息，因此只有在您对后台发生的情况感兴趣时，或者您没有使用我们的任何客户端库时，才需要继续阅读。 本部分的目标读者是熟悉 OAuth 2.0 规范 并且了解如何 结合使用 OAuth 2.0 和 Google API 的高级用户。 注意
多方审批
多方审批 (MPA) Beta 版 ：多方审批功能目前处于 Beta 版阶段，未来版本可能会有调整。 多方审批 (MPA) 是 Google Ads 账号的一项安全功能，该功能通过要求其他账号管理员对敏感更改进行确认来防止您的账号出现未经授权的活动。执行添加用户或更改用户角色等敏感操作时，系统会提示账号的其他管理员审批这些更改。 本指南介绍了多方审批功能的运
多用户身份验证工作流
多用户身份验证工作流 注意 ：本指南假定您熟悉 Google Ads 访问权限模型。如果您不熟悉，建议您阅读 Google Ads 访问权限模型 指南，以便熟悉相关概念。 在多用户身份验证工作流中，您可以构建自己的 OAuth 流程来对用户进行身份验证。 Google Identity 文档中讨论了多种应用类型，以及支持该应用类型所需的 Google Clo
使用 OAuth 2.0 访问 Google Ads API
使用 OAuth 2.0 访问 Google Ads API 注意 ： 除了 OAuth 2.0 凭据之外，您还需要 开发者令牌 才能进行 API 调用。 与其他 Google API 一样，Google Ads API 也使用 OAuth 2.0 协议 进行身份验证和授权。借助 OAuth 2.0，您的 Google Ads API 客户端应用就能够访问用
安全性要求
安全性要求 注意 ： 本指南仅适用于您使用 用户身份验证工作流 的情况。 本指南介绍了 Google Ads 和 Google Ads API 用户的常见安全要求。 什么是两步验证？ 两步验证 (2SV) 也称为双重身份验证 (2FA)，是一种 多重身份验证 (MFA) 方式，除了用户名和密码之外，还会添加第二种持有因素（“您拥有的东西”）。 双重身份验证
服务账号工作流程
服务账号工作流程 注意 ： 本指南假定您熟悉 Google Ads 访问权限模型。如果您不熟悉，建议您阅读 Google Ads 访问权限模型 指南，以便熟悉相关概念。 本指南讨论如何使用服务账号访问 Google Ads API。 服务账号 是属于您的应用而不是某个最终用户的账号。服务账号使用的是无需人工授权的 OAuth 2.0 流程，但需使用只有您的应
单用户身份验证工作流
单用户身份验证工作流 注意 ：本指南假定您熟悉 Google Ads 访问权限模型。如果您不熟悉，建议您阅读 Google Ads 访问权限模型 指南，以便熟悉相关 概念。**注意** ： Google 建议您使用 服务账号工作流 ，而不是单用户身份验证工作 101}流。只有在无法使用服务账号时，才应使用单用户身份验证工作流。 与 服务账号工作流 类似， 单
用户身份验证工作流 · 使用 OAuth 2.0 访问 Google Ads API
用户身份验证工作流 本指南讨论如何通过用户身份验证访问 Google Ads API。如需详细了解各种身份验证选项，请参阅 概览指南 。 用户身份验证工作流涉及使用 OAuth 2.0 流程来获得人工授权，以便让您的应用代表用户管理其 Google Ads 账号。授权流程完成后，系统会颁发 OAuth 2.0 访问令牌，应用可以使用该访问令牌向用户的 Goo