Google Ads Python库深度解析5个核心功能与实战案例【免费下载链接】googleads-python-libThe Python client library for Googles Ads APIs项目地址: https://gitcode.com/gh_mirrors/go/googleads-python-libGoogle Ads Python库是Google官方提供的强大工具专为开发者设计用于轻松访问Google Ad Manager SOAP API。这个Python客户端库简化了广告管理系统的集成流程让开发者能够高效管理广告投放、生成报表和分析数据。无论您是广告技术开发者还是数据分析师掌握这个库都能大幅提升您的工作效率。1. 智能报表生成与分析功能Google Ads Python库最强大的功能之一是报表生成与分析。通过内置的ReportService您可以轻松创建各种广告性能报表包括投放报告、库存报告和销售报告。实战案例自动化投放报告生成让我们看看如何创建一个自动化投放报告系统。首先您需要配置认证信息然后使用DataDownloader来获取报表数据from googleads import ad_manager from datetime import datetime, timedelta # 初始化客户端 ad_manager_client ad_manager.AdManagerClient.LoadFromStorage() # 创建报表查询 report_job { reportQuery: { dimensions: [ORDER_ID, ORDER_NAME], columns: [AD_SERVER_IMPRESSIONS, AD_SERVER_CLICKS, AD_SERVER_CTR], dateRangeType: CUSTOM_DATE, startDate: datetime.now().date() - timedelta(days7), endDate: datetime.now().date() } } # 下载报表数据 report_downloader ad_manager_client.GetDataDownloader(versionv202511) report_job_id report_downloader.WaitForReport(report_job)这个功能位于examples/ad_manager/v202511/report_service/目录中包含多个报表示例如run_delivery_report.py、run_inventory_report.py等。2. 灵活的认证与客户端管理Google Ads Python库支持多种认证方式包括服务账户认证和OAuth2流程确保您的API调用安全可靠。实战案例服务账户认证配置使用服务账户进行认证是最安全的方式之一。以下是配置服务账户认证的步骤from googleads import ad_manager from googleads import oauth2 # 配置服务账户认证 oauth2_client oauth2.GoogleServiceAccountClient( path/to/service-account-key.json, oauth2.GetAPIScope(ad_manager) ) # 创建Ad Manager客户端 ad_manager_client ad_manager.AdManagerClient( oauth2_client, 您的应用名称 ) # 测试连接 networks ad_manager_client.GetService(NetworkService).getAllNetworks()认证配置文件位于项目根目录的googleads.yaml文件中您可以根据需要配置不同的认证方式。3. 精准广告库存管理通过InventoryService您可以全面管理广告单元和库存包括创建、更新和归档广告单元。实战案例批量创建广告单元# 创建广告单元服务实例 inventory_service ad_manager_client.GetService(InventoryService, versionv202511) # 定义新广告单元 new_ad_units [{ name: 首页横幅广告, parentId: 123456789, # 父级广告单元ID adUnitSizes: [{ size: {width: 728, height: 90}, environmentType: BROWSER }] }] # 批量创建广告单元 created_ad_units inventory_service.createAdUnits(new_ad_units)您可以在examples/ad_manager/v202511/inventory_service/目录中找到完整的库存管理示例包括create_ad_units.py和get_ad_unit_hierarchy.py等。4. 智能广告投放控制LineItemService提供了完整的广告投放控制功能包括创建广告订单、设置投放规则和监控投放状态。实战案例创建视频广告投放# 获取LineItemService实例 line_item_service ad_manager_client.GetService(LineItemService, versionv202511) # 创建视频广告投放 video_line_item { name: 夏季促销视频广告, orderId: order_id, targeting: { inventoryTargeting: { targetedAdUnits: [{adUnitId: ad_unit_id}] } }, creativePlaceholders: [{ size: {width: 640, height: 360} }], startDateTimeType: IMMEDIATELY, lineItemType: SPONSORSHIP, costType: CPM } # 创建投放 created_line_item line_item_service.createLineItems([video_line_item])相关示例代码位于examples/ad_manager/v202511/line_item_service/目录特别是create_video_line_item.py文件。5. 创意内容管理系统CreativeService允许您管理广告创意内容包括图片、视频和原生广告创意。实战案例批量上传图片创意# 获取CreativeService实例 creative_service ad_manager_client.GetService(CreativeService, versionv202511) # 准备图片创意数据 image_creatives [] for i in range(5): creative { xsi_type: ImageCreative, name: f横幅广告_{i1}, advertiserId: advertiser_id, size: {width: 300, height: 250}, primaryImageAsset: { assetByteArray: image_data, # 图片二进制数据 fileName: fbanner_{i1}.jpg } } image_creatives.append(creative) # 批量创建创意 created_creatives creative_service.createCreatives(image_creatives)创意管理示例位于examples/ad_manager/v202511/creative_service/目录包括create_creatives.py和copy_image_creatives.py等文件。 快速入门指南安装与配置安装库pip install googleads配置认证 复制googleads.yaml文件到您的主目录并填写必要的认证信息ad_manager: application_name: 您的应用名称 network_code: 您的网络代码 path_to_private_key_file: /path/to/service-account-key.json测试连接from googleads import ad_manager # 加载配置 client ad_manager.AdManagerClient.LoadFromStorage() # 测试API连接 network_service client.GetService(NetworkService) networks network_service.getAllNetworks()最佳实践建议错误处理始终使用try-except块处理API错误分页处理使用StatementBuilder进行大数据集的分页查询缓存配置根据环境配置适当的缓存策略日志记录启用SOAP交互日志以便调试性能优化批量操作减少API调用次数 核心模块路径参考主要客户端模块googleads/ad_manager.py认证模块googleads/oauth2.py通用工具googleads/common.py错误处理googleads/errors.py示例代码examples/ad_manager/v202511/总结Google Ads Python库为开发者提供了完整的Google Ad Manager API访问能力。通过这5个核心功能——智能报表生成、灵活认证管理、精准库存控制、智能投放管理和创意内容系统您可以构建强大的广告管理应用。无论是自动化报表系统、批量广告管理还是实时投放监控这个库都能帮助您高效完成任务。记住良好的代码结构、适当的错误处理和合理的API调用频率是成功使用Google Ads Python库的关键。从简单的报表生成开始逐步扩展到复杂的广告管理功能您将发现这个库的强大之处。【免费下载链接】googleads-python-libThe Python client library for Googles Ads APIs项目地址: https://gitcode.com/gh_mirrors/go/googleads-python-lib创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考