### 使用 `google-ads-python` 实现自动化搜索广告操作 为了利用 `google-ads-python` 客户端库来自动创建或管理Google Ads中的搜索广告，开发者需遵循特定流程并调用相应API方法。此过程涉及设置环境、初始化客户端以及执行具体的操作。 #### 设置开发环境 确保已安装必要的依赖项，并配置好访问权限。可以通过pip工具安装该库： ```bash pip install google-ads ``` #### 初始化 Google Ads 客户端 在使用任何功能前，先要通过加载配置文件的方式实例化一个Google Ads客户对象。通常情况下，这涉及到读取包含认证信息和服务账户详情的YAML配置文件[^1]。 ```python from google.ads.google_ads.client import GoogleAdsClient client = GoogleAdsClient.load_from_storage('path/to/google-ads.yaml') ``` #### 创建 Campaign 和 AdGroup 对于新建广告活动（Campaign），可以定义预算、网络设置等参数；而对于广告组（Ad Group），则指定目标关键词和其他投放选项。下面是一个简单的例子展示如何构建这些实体。 ```python def create_campaign(client, customer_id): campaign_service = client.get_service("CampaignService", version="v8") # Define budget details. campaign_budget_operation = client.get_type("CampaignBudgetOperation", version="v8") campaign_budget = campaign_budget_operation.create campaign_budget.name = "Interplanetary Cruise Budget" campaign_budget.delivery_method = ( client.enums.BudgetDeliveryMethodEnum.STANDARD ) campaign_budget.amount_micros = 500000 try: response = campaign_service.mutate_campaign_budgets( customer_id=customer_id, operations=[campaign_budget_operation], ) print(f"Created campaign budget with resource name {response.results[0].resource_name}") return response.results[0].resource_name except Exception as ex: raise ValueError(ex) def create_ad_group(client, customer_id, campaign_resource_name): ad_group_operation = client.get_type("AdGroupOperation", version="v8") ad_group = ad_group_operation.create ad_group.name = "Earth to Mars Cruises" ad_group.campaign = campaign_resource_name ad_group.status = client.enums.AdGroupStatusEnum.ENABLED ad_group.type_ = client.enums.AdGroupTypeEnum.SEARCH_STANDARD ad_group.cpc_bid_micros = 10000000 ad_group_service = client.get_service("AdGroupService", version="v8") try: response = ad_group_service.mutate_ad_groups( customer_id=customer_id, operations=[ad_group_operation], ) print(f"Created ad group with resource name {response.results[0].resource_name}") return response.results[0].resource_name except Exception as ex: raise ValueError(ex) ``` #### 添加关键字和扩展文字广告 一旦有了有效的广告系列和广告组之后，就可以向其中加入具体的广告内容——比如文本广告或是产品列表广告。这里给出了一种方式用于增加基于文本的关键字匹配类型的广告。 ```python def add_keywords_and_text_ads(client, customer_id, ad_group_resource_name): keyword_plan_network = client.enums.KeywordPlanNetworkEnum.GOOGLE_SEARCH_AND_PARTNERS match_type_enum = client.enums.KeywordMatchTypeEnum.EXACT keywords = ["mars cruise deals"] text_ads = [ { 'headline_part1': 'Travel to Mars', 'headline_part2': 'Book Your Seat Today!', 'description': 'Experience the red planet like never before.' } ] operation_list = [] for kw in keywords: criterion_op = client.get_type("AdGroupCriterionOperation", version="v8") criterion = criterion_op.create criterion.keyword.text = kw criterion.keyword.match_type = match_type_enum criterion.ad_group = ad_group_resource_name operation_list.append(criterion_op) for ta in text_ads: adgroup_ad_op = client.get_type("AdGroupAdOperation", version="v8") adgroup_ad = adgroup_ad_op.create expanded_text_ad_info = adgroup_ad.ad.expanded_text_ad expanded_text_ad_info.headline_part1 = ta['headline_part1'] expanded_text_ad_info.headline_part2 = ta['headline_part2'] expanded_text_ad_info.description = ta['description'] adgroup_ad.ad.final_urls.extend(['http://www.example.com']) adgroup_ad.ad_group = ad_group_resource_name operation_list.append(adgroup_ad_op) ad_group_criterion_service = client.get_service("AdGroupCriterionService", version="v8") ad_group_ad_service = client.get_service("AdGroupAdService", version="v8") try: responses = [] if len(operation_list) > 0: criteria_response = ad_group_criterion_service.mutate_ad_group_criteria( customer_id=customer_id, operations=operation_list[:len(keywords)] ) ads_response = ad_group_ad_service.mutate_ad_group_ads( customer_id=customer_id, operations=operation_list[len(keywords):] ) responses += list(criteria_response.results) responses += list(ads_response.results) for result in responses: print(f'Added entity with resource name "{result.resource_name}"') except Exception as ex: raise ValueError(ex) ``` 上述代码片段