用google-ads-python增删改查广告：10个高频广告操作代码示例，简单到直接复制就能用

用google-ads-python增删改查广告10个高频广告操作代码示例简单到直接复制就能用【免费下载链接】google-ads-pythonGoogle Ads API Client Library for Python项目地址: https://gitcode.com/gh_mirrors/go/google-ads-python 本文带你用google-ads-pythonGoogle Ads API 官方 Python 客户端库快速完成广告账户的增、删、改、查操作。它通过pip install google-ads一行命令安装配合官方示例目录examples/下的大量可运行脚本让你不用死磕 API 文档复制修改就能上手。文章精选 10 个最高频的广告操作代码示例——从创建广告系列、查询广告到修改、暂停、删除全部一次讲透新手也能照着直接跑通。10 个高频广告操作速查表先给你一张总览表每个操作对应examples/basic_operations/目录下的一个官方示例文件照着做即可#操作增删改查官方示例文件核心 Service1查询所有广告系列查examples/basic_operations/get_campaigns.pyGoogleAdsService2新增广告系列与预算增examples/basic_operations/add_campaigns.pyCampaignService3新增广告组增examples/basic_operations/add_ad_groups.pyAdGroupService4删除广告系列删examples/basic_operations/remove_campaign.pyCampaignService5更新广告系列状态改examples/basic_operations/update_campaign.pyCampaignService6查询响应式搜索广告查examples/basic_operations/get_responsive_search_ads.pyGoogleAdsService7更新广告组出价改examples/basic_operations/update_ad_group.pyAdGroupService8更新响应式搜索广告文案改examples/basic_operations/update_responsive_search_ad.pyAdService9暂停单个广告改examples/basic_operations/pause_ad.pyAdGroupAdService10统一异常处理必备各示例内置handle_googleads_exception—核心思路查操作走GoogleAdsService的 GAQL 查询增、删、改统一走各资源 Service 的mutate_*方法通过 Operation 的create/update/remove三个槽位区分动作。快速开始安装 google-ads-python 并加载客户端一步安装pip install google-ads两步配置只需一次在用户主目录创建google-ads.yaml填入developer_token开发者令牌、refresh_token、client_id、client_secret等认证信息运行时通过命令行参数-c传入数字形式的客户 ID去掉横杠。所有示例都用下面这段代码加载客户端这也是你写任何增删改查脚本的第一行from google.ads.googleads.client import GoogleAdsClient googleads_client GoogleAdsClient.load_from_storage(versionv24)⚠️ 常见报错developer token is not valid 或 missing customer id90% 的情况是google-ads.yaml没放对位置或客户 ID 带了横杠。查询广告get_campaigns 流式查询所有广告系列查是最高频操作核心是 GAQLGoogle Ads Query Language——写法像 SQL。examples/basic_operations/get_campaigns.py里的精华就 8 行ga_service client.get_service(GoogleAdsService) query SELECT campaign.id, campaign.name FROM campaign ORDER BY campaign.id for batch in ga_service.search_stream(customer_idcustomer_id, queryquery): for row in batch.results: print(fCampaign with ID {row.campaign.id} and name \{row.campaign.name}\ was found.) 两个要点小结果集用ga_service.search(request...)一次返回大报表用search_stream分批流式返回防止内存爆掉不确定该查哪些字段官方示例examples/basic_operations/search_for_google_ads_fields.py专门演示了如何用 GAQL 搜索可用字段。新增广告add_campaigns 创建预算 广告系列examples/basic_operations/add_campaigns.py演示了标准流程先建预算再建广告系列。两个关键片段# 1. 创建预算可被多个广告系列共享 campaign_budget_operation client.get_type(CampaignBudgetOperation) campaign_budget campaign_budget_operation.create campaign_budget.name fInterplanetary Budget {uuid.uuid4()} campaign_budget.amount_micros 500000 # 金额单位为微元500000 ≈ 0.5 元 campaign_budget_service.mutate_campaign_budgets( customer_idcustomer_id, operations[campaign_budget_operation] )# 2. 创建广告系列先 PAUSED加好定向和广告后再开启 campaign_operation client.get_type(CampaignOperation) campaign campaign_operation.create campaign.name fInterplanetary Cruise {uuid.uuid4()} campaign.advertising_channel_type client.enums.AdvertisingChannelTypeEnum.SEARCH campaign.status client.enums.CampaignStatusEnum.PAUSED campaign.manual_cpc client.get_type(ManualCpc) campaign.campaign_budget budget_response.results[0].resource_name campaign.network_settings.target_google_search True campaign.network_settings.target_search_network True campaign_service.mutate_campaigns( customer_idcustomer_id, operations[campaign_operation] )⚡ 记住一个铁律新建广告系列一律先设PAUSED等广告配齐再改ENABLED避免广告还没配好就开始烧钱。新增广告组add_ad_groups 三行搞定广告组是广告系列下的分类容器examples/basic_operations/add_ad_groups.py的main函数只有 20 行出头ad_group_operation client.get_type(AdGroupOperation) ad_group ad_group_operation.create ad_group.name fEarth to Mars cruises {uuid.uuid4()} ad_group.status client.enums.AdGroupStatusEnum.ENABLED ad_group.campaign campaign_service.campaign_path(customer_id, campaign_id) ad_group.type_ client.enums.AdGroupTypeEnum.SEARCH_STANDARD ad_group.cpc_bid_micros 10000000 # 最高 CPC 出价 ad_group_service.mutate_ad_groups( customer_idcustomer_id, operations[ad_group_operation] )campaign_path(customer_id, campaign_id)会自动拼出资源路径比自己手写字符串安全可靠得多。删除广告系列remove_campaign 只需一个 remove 字段examples/basic_operations/remove_campaign.py是全目录最精简的示例删除逻辑只有 5 行campaign_operation client.get_type(CampaignOperation) campaign_operation.remove campaign_service.campaign_path( customer_id, campaign_id ) campaign_service.mutate_campaigns( customer_idcustomer_id, operations[campaign_operation] ) 看出规律了吗同一个mutate_campaigns入口Operation 用create字段就是增、用update字段就是改、用remove字段就是删——这就是 Google Ads API 统一的mutate 模式。更新广告系列update_campaign 别忘了 update_mask修改操作的完整套路见examples/basic_operations/update_campaign.pycampaign_operation client.get_type(CampaignOperation) campaign campaign_operation.update campaign.resource_name campaign_service.campaign_path(customer_id, campaign_id) campaign.status client.enums.CampaignStatusEnum.PAUSED campaign.network_settings.target_search_network False # 关键告诉 API 只更新上面设置过的字段 client.copy_from( campaign_operation.update_mask, protobuf_helpers.field_mask(None, campaign._pb), ) campaign_service.mutate_campaigns( customer_idcustomer_id, operations[campaign_operation] )⚠️update_mask字段掩码是改操作最容易踩的坑Google Ads API 要求你明确声明我到底改了哪些字段漏掉它请求会直接报错。好消息是所有示例都用field_mask(None, campaign._pb)自动生成你照抄就不会错。查询响应式搜索广告按广告类型筛选examples/basic_operations/get_responsive_search_ads.py展示了如何用 GAQL 查具体广告素材包括标题和描述文案query SELECT ad_group.id, ad_group_ad.ad.id, ad_group_ad.ad.responsive_search_ad.headlines, ad_group_ad.ad.responsive_search_ad.descriptions, ad_group_ad.status FROM ad_group_ad WHERE ad_group_ad.ad.type RESPONSIVE_SEARCH_AD AND ad_group_ad.status ! REMOVED 技巧查询里加WHERE ad_group.id {ad_group_id}可以把结果限定到某个广告组排查素材问题时非常好用。更新广告组改状态、调出价examples/basic_operations/update_ad_group.py演示最常见的调整出价 暂停广告组组合操作ad_group_operation client.get_type(AdGroupOperation) ad_group ad_group_operation.update ad_group.resource_name ad_group_service.ad_group_path(customer_id, ad_group_id) ad_group.status client.enums.AdGroupStatusEnum.PAUSED ad_group.cpc_bid_micros cpc_bid_micro_amount client.copy_from( ad_group_operation.update_mask, protobuf_helpers.field_mask(None, ad_group._pb), ) ad_group_service.mutate_ad_groups( customer_idcustomer_id, operations[ad_group_operation] )和更新广告系列完全同构定位resource_name→ 改字段 → 生成update_mask→mutate_*提交。更新响应式搜索广告批量换标题和描述改广告文案是日常最高频的改操作examples/basic_operations/update_responsive_search_ad.py给了标准写法ad ad_operation.update ad.resource_name ad_service.ad_path(customer_id, ad_id) headline_1 client.get_type(AdTextAsset) headline_1.text fCruise to Pluto #{uuid4().hex[:8]} headline_1.pinned_field client.enums.ServedAssetFieldTypeEnum.HEADLINE_1 headline_2 client.get_type(AdTextAsset) headline_2.text Tickets on sale now ad.responsive_search_ad.headlines.extend([headline_1, headline_2, headline_3]) ad.responsive_search_ad.descriptions.extend([description_1, description_2]) ad.final_urls.append(https://www.example.com)pinned_field可以钉住某条标题固定展示在第一位A/B 测试文案时非常实用。暂停广告pause_ad 精准停掉单个广告想只停某一条广告、不动整个广告组examples/basic_operations/pause_ad.py演示了粒度最细的改状态ad_group_ad_operation client.get_type(AdGroupAdOperation) ad_group_ad ad_group_ad_operation.update ad_group_ad.resource_name ad_group_ad_service.ad_group_ad_path( customer_id, ad_group_id, ad_id ) ad_group_ad.status client.enums.AdGroupAdStatusEnum.PAUSED client.copy_from( ad_group_ad_operation.update_mask, protobuf_helpers.field_mask(None, ad_group_ad._pb), ) ad_group_ad_service.mutate_ad_group_ads( customer_idcustomer_id, operations[ad_group_ad_operation] ) 注意路径参数多了一层广告挂在广告组下面所以是ad_group_ad_path(customer_id, ad_group_id, ad_id)。错误处理让报错信息一眼看懂所有示例都内置了同一个异常处理函数建议直接抄进你的项目def handle_googleads_exception(exception): print( fRequest with ID {exception.request_id} failed with status f{exception.error.code().name} and includes the following errors: ) for error in exception.failure.errors: print(f\tError with message {error.message}.) if error.location: for field_path_element in error.location.field_path_elements: print(f\t\tOn field: {field_path_element.field_name})它会把 Google 返回的错误消息 出错字段路径逐条打印出来比如budget amount too small会精确指向是哪个字段——排查问题的效率直接翻倍。常见问题 FAQQ1版本号 v24 是从哪来的Aload_from_storage(versionv24)指定 API 版本。库内同时提供 v21 到 v25 多个版本目录如google/ads/googleads/v24/示例当前统一使用 v24升级版本时只需改这一处。Q2批量操作几百条广告会不会很慢Amutate_*方法本身就接受 Operation 列表一次请求可以提交多条增删改更大的批量场景可以参考examples/campaign_management/add_complete_campaigns_using_batch_job.py使用异步 Batch Job以及examples/reporting/parallel_report_download.py并行拉取报表。Q3能写异步async脚本吗A可以。examples/asyncio/目录提供了async_search.py、async_add_campaigns.py等完整示例用GoogleAdsClient.load_from_storage后直接await即可。Q4金额单位总是搞混AGoogle Ads API 的金额单位是微元1 元 1,000,000 微元所以amount_micros 500000表示 0.5 元。写在最后10 个示例串起来就是一条完整的广告运维动线配置客户端 → GAQL 查询 → 建预算建广告系列 → 建广告组 → 改状态调出价 → 换广告文案 → 暂停 → 删除。掌握mutate_* Operation 的统一模式剩下就是换 Service 和换字段。 下一步建议从examples/basic_operations/跑通第一个查询开始再按需进入examples/advanced_operations/高级操作、examples/error_handling/异常处理目录深入。祝你早日写出第一个自动化投放脚本【免费下载链接】google-ads-pythonGoogle Ads API Client Library for Python项目地址: https://gitcode.com/gh_mirrors/go/google-ads-python创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考