版本資訊

規劃

• (僅限許可清單中的帳戶) 新增適用於 ContentCreatorInsightsService.GenerateCreatorInsights 方法的新服務，讓使用者取得熱門 YouTube 創作者的深入分析。這可讓客戶根據指定目標對象和指定內容組合，或是根據 YouTube 頻道 ID 清單提供的創作者洞察資料，搜尋創作者。
• 對 AudienceInsightsService.GenerateSuggestedTargetingInsights 的更新：
  • 已將 audience、baseline_audience 和 data_month 移至 audience_definition。
  • 新增「audience_description」，利用生成式 AI 根據任意形式的文字說明生成指定目標建議。
• 新增AudienceInsightsService.GenerateTargetingSuggestionMetrics，可傳回特定指定目標對象組合的潛在觸及指標。

建議

• RecommendationService.GenerateRecommendations 現在可用於在建立廣告活動時，產生最佳化預算建議。只要在 GenerateRecommendationsRequest.recommendation_types[] 中加入 CAMPAIGN_BUDGET 最佳化建議類型，即可產生建議。這適用於最高成效廣告活動和搜尋廣告活動。

報表

• 將 SearchGoogleAdsRequest 的 summary_row_setting 和 return_total_results_count 欄位替換為 search_settings 欄位，其類型為 SearchSettings，並包含下列欄位：
  • omit_results
  • return_summary_row
  • return_total_results_count
• 新增以下指標，用於追蹤一般無效點擊，例如機器人或檢索器產生的點擊，以及具有不規則模式的點擊。您可以使用 campaign 報表查詢。
  • metrics.general_invalid_clicks
  • metrics.general_invalid_click_rate
• 在 QuotaError 中新增下列值：
  • EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION
  • EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION

v17.1.0 (2024-08-07)

以下新功能和更新已在 v17_1 中新增。

素材資源

• AdGroupAdService.RemoveAutomaticallyCreatedAssets() 可讓您移除已連結至回應式搜尋廣告的指定自動建立的素材資源。

目標對象

• UserListCustomerTypeCategory 中的新列舉值：
  • LOYALTY_TIER_1_MEMBERS
  • LOYALTY_TIER_2_MEMBERS
  • LOYALTY_TIER_3_MEMBERS
  • LOYALTY_TIER_4_MEMBERS
  • LOYALTY_TIER_5_MEMBERS
  • LOYALTY_TIER_6_MEMBERS
  • LOYALTY_TIER_7_MEMBERS

廣告活動

• ShareablePreviewService.GenerateShareablePreviews() 會為已啟用和已暫停的素材資源群組產生可分享廣告預覽的網址 (回應中的 shareable_preview_url)。
  • expiration_date_time 欄位代表回應中網址的到期日。
  • 如果發生錯誤，這個方法會傳回 partial_failure_error，而不是網址。

變更記錄

• 新的變更狀態資源類型：ASSET_GROUP。

轉換

• 適用於 SKAdNetwork 版本的新區隔欄位：segments.sk_ad_network_version
• offline_conversion_upload_conversion_action_summary：顯示轉換動作層級的轉換上傳診斷資料。
• 系統會將下列指標加入離線診斷報表，以提供仍在處理中的上傳轉換次數：
  • offline_conversion_upload_client_summary
    • pending_event_count
    • pending_rate
  • offline_conversion_upload_conversion_action_summary：
    • pending_count

規劃

• AudienceInsights.GenerateAudienceOverlapInsights() 可接受輸入主要屬性和一組目標對象屬性，並傳回主要屬性與目標對象屬性之間的潛在 YouTube 觸及預估值。

報表

• 支援根據 segments.date 區隔 per_store_view

影片

• 支援使用報表 (例如 ad_group、campaign) 擷取影片廣告活動的下列標準出價策略相關資訊：
  • Campaign.fixed_cpm (固定千次曝光出價)
  • Campaign.target_cpv (目標單次收視出價)
• Campaign.video_campaign_settings 可讓您運用下列報表欄位，決定要在哪些廣告空間顯示影片廣告：
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_in_feed
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_in_stream
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_shorts
• segments.ad_format_type，可讓您根據影片廣告格式類型區隔下列報表：
  • ad_group
  • ad_group_ad
  • ad_group_ad_asset_view
  • campaign
  • customer

v17 (2024-06-05)

以下功能和變更已在 v17 中新增。

廣告

• 已移除 AdService.getAd。這可讓 AdService 與 Google Ads API 中的其他服務保持一致。如要瞭解擷取廣告和其他資源類型的建議方式，請參閱「擷取物件」。
• 針對 ImageAdInfo.image_asset 新增了更多維度和格式驗證機制。如果圖片： 無效：
  • ImageError.UNEXPECTED_SIZE
  • ImageError.FORMAT_NOT_ALLOWED

素材資源

• 新增列舉：ClickType.AD_IMAGE
• 新增下列報表，其中包含最高成效和搜尋廣告活動的新指標：
  • campaign_aggregate_asset_view
  • channel_aggregate_asset_view

目標對象

• 已新增「OfflineUserDataJobError.OPERATION_LEVEL_CONSENT_PROVIDED」

批次工作

• 新增 BatchJobError.REQUEST_TOO_LARGE，當提交的 AddBatchJobOperationsRequest 大於 10484504 個位元組時，系統會擲回此例外狀況。
• 新增支援使用 BatchJobService 時設定 MutateOperation.asset_group_operation。這樣一來，您就能使用批次處理功能建立及管理整個最高成效廣告活動。請參閱新的專屬指南。

廣告活動

• 在所有欄位、列舉和錯誤中，所有欄位、列舉和錯誤都將「探索」重新命名為「需求開發」 Google Ads API 的所有資源，例如廣告活動、廣告和素材資源。適用對象 例如，AdvertisingChannelType.DISCOVERY 現在是 AdvertisingChannelType.DEMAND_GEN。
• 已新增 Campaign.keyword_match_type 可讓您為廣告活動中的所有關鍵字設定關鍵字比對類型。

轉換

• 針對 SKAdNetwork 轉換，
  • 已將 segments.sk_ad_network_conversion_value 重新命名為 segments.sk_ad_network_fine_conversion_value。
  • 已新增segments.sk_ad_network_redistributed_fine_conversion_value。
• 現在即使 則為零因此與其他指標一致。
  • metrics.all_conversions_value_by_conversion_date
  • metrics.all_conversions_by_conversion_date
  • metrics.conversions_value_by_conversion_date
  • metrics.conversions_by_conversion_date

條件

• 已將下列欄位新增至 AdGroupCriterion 指出廣告群組條件是否已放送，或是未放送的原因 放送：
  • primary_status
  • primary_status_reasons
• 新增對 metrics.search_impression_share 的支援 適用於 gender_view
• 新增對 metrics.phone_calls 的支援 適用於 keyword_view

在地生活服務

• 新增 LocalServicesLeadService.AppendLeadConversation()，用於將新的 LocalServicesLeadConversation 附加至 LocalServicesLead，並根據待開發客戶的建立方式，透過簡訊等適當管道將訊息傳送給使用者。
  • AppendLeadConversationRequest.conversations 的大小上限為 1,000。
  • Conversation.local_services_lead 中只能指定 LocalServicesLead，且 lead_type 必須設為 LeadType.MESSAGE。
• 已將新的列舉值新增至 ConversationType：
  • WHATSAPP 代表透過 WhatsApp 引入的對話。
  • ADS_API，表示使用新的 LocalServicesLeadService.AppendLeadConversation() 方法。
• 在 local_services_verification_artifact 中新增下列欄位：
  • local_services_verification_artifact.insurance_verification_artifact.expiration_date_time
  • local_services_verification_artifact.license_verification_artifact.expiration_date_time

報表

• 您現在可以只選取與一項 已連結的產品相關的欄位 (在查詢 product_link 時)。選取多個項目 多個已連結產品中的欄位 QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE。 舉例來說，您無法在同一個查詢中選取 product_link.advertising_partner.customer 和 product_link.data_partner.data_partner_id。
• 將 page_size 傳遞至 GoogleAdsService.Search 會導致 RequestError.PAGE_SIZE_NOT_SUPPORTED 錯誤。

購物

• 新增報表 shopping_product，對應至 Google Ads UI 的「產品」頁面。這項作業可從已連結至 Google Ads 帳戶的 Google Merchant Center 帳戶，傳回與產品目前狀態相關的資料。
  • 您可以篩選下列指標： shopping_product 報表，使用： segments.date (使用中) GoogleAdsService.Search 或 GoogleAdsService.SearchStream。 系統不允許依日期進行區隔，且會傳回 ShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION 錯誤。

統一的目標

• 已新增「UserListCustomerTypeService.MutateUserListCustomerTypes()」 設定目標對象客戶 類型。
• 移除了 CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings。如要調整客戶生命週期目標的目標對象設定，請使用 請改為使用「UserListCustomerTypeService.MutateUserListCustomerTypes()」。
  • 您可以將UserListCustomerType.customer_type_category 設為 UserListCustomerTypeCategory.PURCHASERS，分別將使用者名單納入或排除在現有顧客定義中，用於顧客生命週期目標。造訪區隔 目標對象 ，掌握更多詳細資訊。

影片

• 將下列值新增至 ContentLabelType。 您可以在客戶層級排除這些ContentLabelTypes：
  • BRAND_SUITABILITY_CONTENT_FOR_FAMILIES
  • BRAND_SUITABILITY_GAMES_FIGHTING
  • BRAND_SUITABILITY_GAMES_MATURE
  • BRAND_SUITABILITY_HEALTH_SENSITIVE
  • BRAND_SUITABILITY_HEALTH_SOURCE_UNDETERMINED
  • BRAND_SUITABILITY_NEWS_RECENT
  • BRAND_SUITABILITY_NEWS_SENSITIVE
  • BRAND_SUITABILITY_NEWS_SOURCE_NOT_FEATURED
  • BRAND_SUITABILITY_POLITICS
  • BRAND_SUITABILITY_RELIGION
• 已新增「AdVideoAsset.ad_video_asset_info」 建立用來支援影片素材資源的廣告空間偏好設定 DemandGenVideoResponsiveAdInfo。
• (僅限許可清單帳戶) 使 Campaign.video_brand_safety_suitability 可變動。

v16.1.0 (2024-04-24)

16.1 版新增了下列功能和異動。

帳戶管理

• CustomerNegativeCriterion.ip_block，可在客戶層級新增 IP 做為排除條件。
• 新列舉值：ProductLinkError.LINK_EXISTS。
• 新列舉值：ProductLinkInvitationError.CUSTOMER_NOT_PERMITTED_TO_CREATE_INVITATION。

素材資源

• 支援需求開發相關素材資源： ad_group_ad_asset_view和 asset_field_type_view。
• 新的列舉值： AssetFieldType.DISCOVERY_CAROUSEL_CARD。

目標對象

• 新列舉值：ResourceLimitType.LOOKALIKE_USER_LISTS_PER_CUSTOMER，可將客戶可擁有的相似目標對象使用者清單數量限制在 1000 個。

廣告活動

• 使用campaign_simulation報表，針對應用程式廣告活動回報目標廣告投資報酬率廣告活動出價模擬結果。
• 新的列舉值： CampaignError.DYNAMIC_TEXT_ASSET_CANNOT_OPT_OUT_WITH_FINAL_URL_EXPANSION_OPT_IN。
• 新的列舉值： AdGroupPrimaryStatusReason.AD_GROUP_PAUSED_DUE_TO_LOW_ACTIVITY。
• 新列舉值：CampaignCriterionError.CANNOT_REMOVE_ALL_LOCATIONS_DUE_TO_TOO_MANY_COUNTRY_EXCLUSIONS。

轉換

• SkAdNetworkConversionValueSchema.postback_mappings，支援 SKAdNetwork 4.0 功能。
• 新增對 CustomerSkAdNetworkConversionValueSchemaService 警告的支援，做為 MutateCustomerSkAdNetworkConversionValueSchemaRequest.enable_warnings。如果設為 true，則所有與作業失敗相關的非阻斷錯誤 會傳回 MutateCustomerSkAdNetworkConversionValueSchemaResponse.warning。
• CustomerSkAdNetworkConversionValueSchemaError 中的新列舉值：
  • INVALID_EVENT_COUNTER
  • INVALID_EVENT_NAME

條件

• BrandInfo 中的新欄位：
  • display_name
  • primary_url
  • rejection_reason
  • status
• 新列舉：BrandRequestRejectionReason。
• 新列舉值：CriterionType.LIFE_EVENT。

實驗

• 新的列舉值：ExperimentError.INVALID_DURATION_FOR_AN_EXPERIMENT。

在地生活服務

• local_services_lead.credit_details.credit_state 和 local_services_lead.credit_details.credit_state_last_update_date_time 傳回功勞狀態，以及抵免額狀態時的時間戳記 的更新
• local_services_lead_conversation.message_details.attachment_urls，會傳回可用來下載附件內容的網址。

影片

• customer.video_brand_safety_suitability 和 BrandSafetySuitability，可在客戶層級擷取影片品牌安全合適度。
• 新增列舉值：VideoCampaignError.MUTATE_REQUIRES_RESERVATION。

v16 (2024-02-21)

以下功能和變更已在 v16 中新增。

帳戶管理

• 已將 advertising_partner 從 AccountLink 遷移至 ProductLink 和 ProductLinkInvitation。
• 已從 AccountLink 中移除 data_partner 和 google_ads。
• 新增IdentityVerificationService，用於管理廣告主身分驗證。
  • StartIdentityVerification() 可用於使用提供的 verification_program 啟動驗證工作階段。這個外掛程式會建立新的驗證工作階段，並針對 已成功建立驗證作業。
    • 已新增 IdentityVerificationProgram.ADVERTISER_IDENTITY_VERIFICATION。
  • GetIdentityVerification() 可用於擷取驗證資訊， IdentityVerification 的多個物件。 每個 IdentityVerification 都包含：
    • verification_program 這是身分驗證計畫類型
    • identity_verification_requirement 其中包含了 廣告主應完成驗證
    • verification_progress ，其中包含驗證工作階段的相關詳細資料，包括：
      • program_status 代表這個項目的目前狀態 驗證工作階段
      • action_url 會將客戶導向要完成 驗證。
      • invitation_link_expiration_time 代表 action_url 的到期日
  • 列舉：
    • IdentityVerificationProgram
    • IdentityVerificationProgramStatus
  • 錯誤：
    • IdentityVerificationError
• 已新增 AuthorizationError.ACTION_NOT_PERMITTED_FOR_SUSPENDED_ACCOUNT。

素材資源

• asset_group 的變更：
  • 新增對時間相關區隔的支援，例如 segments.year 和 segments.month。
  • 將 campaign 設為歸因資源，而非 區隔資源

廣告活動

• 需求開發廣告活動異動：
  • 新增支援功能，可將 Campaign.shopping_setting 設為現有需求開發廣告活動。
  • 新增 ShoppingSetting.disable_product_feed，用於停用需求開發廣告活動的選用產品動態饋給。
  • 新增 Ad.demand_gen_product_ad 和對應的 DemandGenProductAdInfo，適用於具有非空值 Campaign.shopping_setting 的需求開發廣告活動。
• 在 AdGroup 中新增下列欄位，顯示 廣告群組正在放送或未放送的原因：
  • primary_status
  • primary_status_reasons
• 已將下列欄位新增至 AdGroupAd，即可顯示 廣告群組廣告正常放送還是未放送的原因：
  • primary_status
  • primary_status_reasons
• 將下列值新增至 AdGroupError:
  • CANNOT_ADD_AD_GROUP_FOR_CAMPAIGN_TYPE
  • INVALID_STATUS

實驗

• 已將Experiment.sync_enabled新增至 指定是否要在實驗中啟用同步處理功能。啟用同步處理功能後，系統會在實驗執行期間，自動將對原始廣告活動所做的變更複製到實驗廣告活動。
• 已新增 ExperimentError.CANNOT_ENABLE_SYNC_FOR_UNSUPPORTED_EXPERIMENT_TYPE。
• 已新增 CampaignError.CANNOT_MODIFY_TEXT_ASSET_AUTOMATION_WITH_ENABLED_TRIAL。

飯店和旅遊業

• 已新增下列欄位 觀光景點：ListingDimensionInfo 廣告可以根據地理位置和城市建立商家資訊群組 可用的旅遊活動：
  • activity_state
  • activity_city
• travel_activity_performance_view 新增了對下列區段的支援：
  • segments.activity_city
  • segments.activity_country
  • segments.activity_state

在地生活服務

• 已新增 LocalServicesVerificationArtifact.business_registration_check_verification_artifact 和 BusinessRegistrationCheckArtifact 能讓廣告客戶監控商業登記進度 驗證程序。
• 已新增資源 local_services_employee 允許 廣告客戶擷取他們加入的員工資訊

規劃

• 已從 AudienceInsightsAttributeMetadata 中移除 score。

建議

• 新增 RecommendationService.GenerateRecommendations()，可根據指定設定 (例如推薦類型和廣告管道類型) 傳回推薦內容。這在廣告活動建構期間特別實用。
• 已新增 RecommendationMetrics.conversions_value。
• 採用未設定關鍵字比對類型的建議關鍵字： recommended_match_type 設為 UNSPECIFIED，而不是 UNKNOWN。
• 新增了下列建議類型：
  • MAXIMIZE_CONVERSION_VALUE_OPT_IN 建議採用「盡量提高轉換價值出價」 策略
  • IMPROVE_GOOGLE_TAG_COVERAGE 方便您在更多網頁上部署 Google 代碼
  • PERFORMANCE_MAX_FINAL_URL_OPT_IN，建議您為最高成效廣告活動開啟最終到達網址擴展功能
  • REFRESH_CUSTOMER_MATCH_LIST，建議更新過去 90 天未更新的客戶名單
  • CUSTOM_AUDIENCE_OPT_IN 因此建議你建立自訂目標對象
  • LEAD_FORM_ASSET，建議您在廣告活動或客戶層級新增待開發客戶表單素材資源
  • IMPROVE_DEMAND_GEN_AD_STRENGTH，建議您改善需求開發廣告活動的廣告優異度

購物

• 新增 CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT 和 CampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS，為連結至 Comparison Shopping Service Center 帳戶的購物廣告活動提供更詳細的錯誤資訊。
• 在 AssetGroupListingGroupFilterError 中新增下列值：
  • DIMENSION_TYPE_NOT_ALLOWED
  • DUPLICATE_WEBPAGE_FILTER_UNDER_ASSET_GROUP
  • FILTER_EXCLUSION_NOT_ALLOWED
  • LISTING_SOURCE_NOT_ALLOWED
  • MULTIPLE_LISTING_SOURCES
  • MULTIPLE_WEBPAGE_CONDITION_TYPES_NOT_ALLOWED
  • MULTIPLE_WEBPAGE_TYPES_PER_ASSET_GROUP
  • PAGE_FEED_FILTER_HAS_PARENT

生命週期目標

• 已將「update」新增至 CustomerLifecycleGoalOperation 和 CampaignLifecycleGoalOperation 讓這些作業類型與 API 中的其他作業類型保持一致 ## 封存的版本資訊

如要查看封存的版本資訊，請參閱「停用的版本」。