此页面由 Cloud Translation API 翻译。

本地生活服务广告系列

借助本地生活服务广告系列，您可以在 Google 上宣传您的商家信息，直接从潜在客户那里获得他们的相关信息。本指南总结了当前版本的 Google Ads API 支持的操作和限制。

支持的操作

支持以下操作。

检索本地生活服务广告系列和预算

您可以使用 GoogleAdsService.Search 或 GoogleAdsService.SearchStream 方法查询 advertising_channel_type = 'LOCAL_SERVICES' 中的广告系列资源，以检索本地生活服务广告系列和预算。示例如下：

SELECT
  campaign.id,
  campaign.status,
  campaign_budget.id,
  campaign_budget.period,
  campaign_budget.amount_micros,
  campaign_budget.type
FROM campaign
WHERE campaign.advertising_channel_type = 'LOCAL_SERVICES'

修改本地生活服务广告系列

您可以更新广告系列的 status 字段和关联的广告系列预算的 amount_micros 字段。

为本地生活服务广告系列设置出价策略

您可以将以下出价策略设置为本地生活服务广告系列的标准出价策略：

ManualCpa（通过设置字段 manual_cpa）

您可以设置 ManualCpa 到 LocalServicesCampaignSettings.category_bids 的出价。您可以通过 Campaign.local_services_campaign_settings 检索和设置本地服务广告系列的 LocalServicesCampaignSettings。
MaximizeConversions（通过设置字段 maximize_conversions）

将广告投放时间设置为广告系列定位条件

您可以将本地生活服务广告系列的广告投放时间设置为广告系列条件。

创建 AdScheduleInfo，并使用 CampaignCriterionService.MutateCampaignCriteria 将其设置为发送到 Google Ads API 的 CampaignCriterion 的 ad_schedule。

设置地理位置定位

如需为本地服务广告系列启用地理位置定位，请使用 CampaignCriterionService.MutateCampaignCriteria 添加 LocationInfo，并将其设置为发送到 Google Ads API 的 CampaignCriterion 的 location。如需了解详情，请参阅地理位置定位。

定位特定的服务类型

如需为特定服务类型启用定位，请添加 LocalServiceIdInfo 并将其设置为服务类型。

您应使用与广告系列的定位地理位置和类别相匹配的服务 ID。

不支持的操作

下表中列出的限制在未来的 Google Ads API 版本中可能会发生变化。

不支持的操作
创建和移除广告系列	Google Ads API 会阻止制作新的本地服务广告系列。
对广告系列中的子实体执行的操作	Google Ads API 不支持在本地服务广告系列中创建、修改、移除或检索广告组、广告或条件。

本地生活服务资源

Google Ads API 中的以下只读报告资源会直接在 Google Ads API 中公开本地生活服务广告中的部分数据：

为了让这些资源返回数据，发出请求的客户账号中必须包含本地服务广告系列。由于每个客户账号只能有一个本地生活服务广告系列，因此这些资源不会指定广告系列。如需确定这些资源所属的广告系列，请使用以下查询：

SELECT campaign.id
FROM campaign
WHERE campaign.advertising_channel_type = 'LOCAL_SERVICES'

本地生活服务主管

LocalServicesLead 会显示在消费者向广告客户拨打电话、发送消息或预订服务时生成的潜在客户的详细信息。

您可以从 local_services_lead 资源检索本地服务潜在客户数据。以下是一个示例查询：

SELECT
  local_services_lead.lead_type,
  local_services_lead.category_id,
  local_services_lead.service_id,
  local_services_lead.contact_details,
  local_services_lead.lead_status,
  local_services_lead.creation_date_time,
  local_services_lead.locale,
  local_services_lead.lead_charged,
  local_services_lead.credit_details.credit_state,
  local_services_lead.credit_details.credit_state_last_update_date_time
FROM local_services_lead

限制

如果 lead_status 等于 WIPED_OUT，则 contact_details 字段为 null。
无法提供 category_id 属于医疗保健类别的潜在客户的数据。

本地生活服务潜在客户对话

LocalServicesLeadConversation 会公开在 LocalServicesLead 中进行的对话的详细信息。与 LocalServicesLead 之间是一对多关系，一个潜在客户可以有许多对话。您可以在 lead 字段中找到相关潜在客户的资源名称。

您可以从 local_services_lead_conversation 资源中检索对话数据。以下是用于过滤电话通话结果的查询示例：

SELECT
  local_services_lead_conversation.id,
  local_services_lead_conversation.conversation_channel,
  local_services_lead_conversation.participant_type,
  local_services_lead_conversation.lead,
  local_services_lead_conversation.event_date_time,
  local_services_lead_conversation.phone_call_details.call_duration_millis,
  local_services_lead_conversation.phone_call_details.call_recording_url,
  local_services_lead_conversation.message_details.text,
  local_services_lead_conversation.message_details.attachment_urls
FROM local_services_lead_conversation
WHERE local_services_lead_conversation.conversation_channel = 'PHONE_CALL'

从 Google Ads API 17 版开始，您可以使用 LocalServicesLeadService.AppendLeadConversation 方法将 LocalServicesLeadConversation 资源附加到 LocalServicesLead。

限制

若要访问通话录音网址，您必须使用至少拥有与潜在客户关联的广告系列所属 Google Ads 客户账号的只读权限的电子邮件地址登录。

一次请求所有对话可能需要很长时间，因此您应按潜在客户过滤对话，例如：

SELECT
  local_services_lead_conversation.id,
  local_services_lead_conversation.event_date_time,
  local_services_lead_conversation.message_details.text
FROM local_services_lead_conversation
WHERE local_services_lead.id = LEAD_ID

本地服务验证工件

LocalServicesVerificationArtifact 会显示广告客户业务的验证数据。请注意，这些验证是业务层面的，不包括针对员工的验证。这些数据包括：

执照验证
保险验证
背景调查验证
工商登记验证

每当向本地生活服务广告提交验证请求时，Google Ads API 都会为其创建一个新的验证工件实例，并且每个验证工件都代表一个验证请求。每个验证工件都可能包含以下部分信息，具体取决于其代表的验证请求类型：

每个验证工件的状态
用于背景调查验证的背景调查网址
背景调查审核时间（如果适用）
保险单据网址，用于查看已提交的保险信息
保险拒绝原因（如果适用）
许可详细信息（类型、编号、名字、姓氏）
许可遭拒原因（如果适用）
用于查看已提交的许可图片的许可文档网址（如果适用）
企业注册详细信息（支票 ID、注册号）
商家注册遭拒原因（如果适用）
用于查看已提交的注册图片的工商登记证件网址（如果适用）

您可以从 local_services_verification_artifact 资源中检索验证工件数据。以下示例查询检索指定客户账号的所有许可相关验证工件的数据：

SELECT
  local_services_verification_artifact.id,
  local_services_verification_artifact.creation_date_time,
  local_services_verification_artifact.status,
  local_services_verification_artifact.artifact_type,
  local_services_verification_artifact.license_verification_artifact.license_type,
  local_services_verification_artifact.license_verification_artifact.license_number,
  local_services_verification_artifact.license_verification_artifact.licensee_first_name,
  local_services_verification_artifact.license_verification_artifact.licensee_last_name,
  local_services_verification_artifact.license_verification_artifact.rejection_reason
FROM local_services_verification_artifact
WHERE local_services_verification_artifact.artifact_type = 'LICENSE'

地理位置和分类执照和保险数据

如需按地理位置（具体而言，是地理位置定位代码）和本地服务类别 ID 以编程方式确定验证请求的状态，您可以在 customer 资源上使用一个名为 LocalServicesSettings 的新字段。

此字段会按地理位置和类别显示许可和保险验证请求的状态概要。以下是检索所有此类数据的查询示例：

SELECT
  customer.local_services_settings.granular_license_statuses,
  customer.local_services_settings.granular_insurance_statuses
FROM customer

本地生活服务员工

LocalServicesEmployee 会公开广告客户将其广告资料上传到我们系统后，系统中关于本地生活服务员工的数据。

下面是一个查询示例，该查询检索指定客户账号的所有本地服务员工的数据：

SELECT
  local_services_employee.status,
  local_services_employee.type,
  local_services_employee.university_degrees,
  local_services_employee.residencies,
  local_services_employee.fellowships,
  local_services_employee.job_title,
  local_services_employee.year_started_practicing,
  local_services_employee.languages_spoken,
  local_services_employee.first_name,
  local_services_employee.middle_name,
  local_services_employee.last_name
FROM local_services_employee