如要討論產品並提供意見，請加入 Google 廣告與評估社群伺服器中的官方 Google Ads Discord 頻道。

本頁面由 Cloud Translation API 翻譯而成。

在地生活服務廣告活動

在地生活服務廣告活動可在 Google 上宣傳你的商家，並直接從潛在顧客中發掘待開發客戶。本指南會概略說明目前 Google Ads API 版本支援的作業和限制。

支援作業

支援的作業如下：

擷取在地生活服務廣告活動和預算

您可以使用 GoogleAdsService.Search 或 GoogleAdsService.SearchStream 方法，查詢 campaign 資源，藉此擷取在地生活服務廣告活動和預算，其中 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 欄位

您可以透過 LocalServicesCampaignSettings.category_bids 設定 ManualCpa 的出價。您可以透過 Campaign.local_services_campaign_settings 擷取及設定在地生活服務廣告活動的 LocalServicesCampaignSettings。
MaximizeConversions，方法是設定 maximize_conversions 欄位。

將廣告時段設為廣告活動條件

您可以將在地生活服務廣告活動的廣告時段設為廣告活動條件。

建立 AdScheduleInfo，並使用 CampaignCriterionService.MutateCampaignCriteria 將其設為傳送至 Google Ads API 的 CampaignCriterion 的 ad_schedule。

設定指定地區

如要為在地服務廣告活動啟用指定地區功能，請新增 LocationInfo，並使用 CampaignCriterionService.MutateCampaignCriteria 將其設為傳送至 Google Ads API 的 CampaignCriterion 的 location。詳情請參閱指定位置。

指定特定服務類型

如要為特定服務類型啟用指定目標，請新增 LocalServiceIdInfo 並設為服務類型。

請使用與廣告活動指定地區和類別相符的服務 ID。

提交待開發客戶意見回饋

使用 LocalServicesLeadService 的 ProvideLeadFeedback() 方法，提交待開發客戶的評分和意見回饋。您也可以檢查 LocalServicesLead 的 lead_feedback_submitted 欄位，判斷是否已為待開發客戶評分並提交意見回饋。

不支援的操作

下表列出的限制可能會在 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 資源擷取 Local Services 待開發客戶資料。以下是查詢範例：

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'

您可以使用 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 就會為該要求建立新的驗證構件例項，每個驗證構件代表一項驗證要求。每個驗證構件可能包含下列部分資訊，視其代表的驗證要求類型而定：

各項驗證構件的狀態
用於驗證背景調查的背景調查網址
背景調查裁決時間 (如適用)
保險文件網址，可查看已提交的保險資訊
保險遭拒原因 (如有)
駕照詳細資料 (類型、號碼、名字、姓氏)
執照遭拒原因 (如適用)
授權文件網址，可查看已提交的授權圖片 (如適用)
商業登記詳細資料 (身分證件、登記編號)
商家登記遭拒原因 (如適用)
公司設立登記文件網址，可查看已提交的登記圖片 (如適用)

您可以從 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

在地生活服務廣告活動 透過集合功能整理內容 你可以依據偏好儲存及分類內容。