本頁面由 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 欄位。

設定在地生活服務廣告活動的出價策略

您可以將下列出價策略設為 Local Services 廣告活動的標準出價策略：

ManualCpa 透過設定欄位 manual_cpa

您可以透過 LocalServicesCampaignSettings.category_bids 設定 ManualCpa 的出價。您可以透過 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 中顯示：

如要讓這些資源傳回資料，客戶帳戶中必須有提出要求的 Local Services 廣告活動。由於每個客戶帳戶只能有一個在地生活服務廣告活動，因此這些資源不會指定廣告活動。如要找出這些資源所屬的廣告活動，請使用下列查詢：

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 欄位為空值。
系統無法提供 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