บันทึกประจำรุ่น

โปรดดูการเลิกใช้งานฟีเจอร์เพื่อดูรายการฟีเจอร์ที่เลิกใช้งานในปัจจุบันและที่วางแผนไว้ซึ่งเป็นข้อมูลล่าสุด

เวอร์ชันหลัก v26

Google Ads API v26 มีฟีเจอร์ใหม่ การอัปเดต และการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบต่อไปนี้

v26 (14-10-2026)

เราได้เพิ่มฟีเจอร์ใหม่ การอัปเดต และการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบต่อไปนี้ใน Google Ads API v26 ซึ่งเป็นการเปิดตัวครั้งสำคัญ

ดูคำแนะนำได้ที่หัวข้ออัปเกรดเป็นเวอร์ชันล่าสุด

การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ

สถานะเริ่มต้น	สถานะใหม่	ประเภทการเปลี่ยนแปลง	หลักเกณฑ์การใช้งาน
แคมเปญ
ช่อง country_code ที่ไม่บังคับใน LocalServicesPmaxCampaignSettings	ช่องที่ต้องกรอกระหว่างการสร้างแคมเปญ Performance Max สำหรับบริการในพื้นที่ (LocalServicesPmaxCampaignSettings.country_code)	การเปลี่ยนแปลงเชิงพฤติกรรม	ตรวจสอบว่าคุณระบุ country_code (พร้อมกับ listing_id ที่จำเป็นใหม่) เมื่อสร้างแคมเปญ Performance Max สำหรับบริการในพื้นที่
Conversion
ฟิลด์ enhanced_conversions_for_leads_enabled ใน ConversionTrackingSetting (Customer.conversion_tracking_setting)	ไม่มี	การนำออก	ใช้ ConversionTrackingSetting.enablement_setting ใน Customer.conversion_tracking_setting แทนเพื่อตรวจสอบการตั้งค่า Conversion ที่ปรับปรุงแล้วระดับบัญชี
การกำหนดเป้าหมาย
ช่องเกณฑ์เฉพาะโรงแรมใน AdGroupBidModifier มีดังนี้ hotel_date_selection_type hotel_advance_booking_window hotel_length_of_stay (min_nights และ max_nights) hotel_check_in_day hotel_check_in_date_range	ช่องเกณฑ์ที่ไม่ขึ้นอยู่กับประเภทธุรกิจใน AdGroupBidModifier: user_set_dates ประเภท UserSetDatesInfo advance_booking_window ประเภท AdvanceBookingWindowInfo length_of_booking ประเภท LengthOfBookingInfo (min_days และ max_days) start_day_of_week ของประเภท StartDayOfWeekInfo start_date_range ประเภท StartDateRangeInfo	การเปลี่ยนชื่อ / การนำออก	อัปเดตการอ้างอิงเพื่อใช้ช่องเกณฑ์ที่ไม่ขึ้นกับอุตสาหกรรม ซึ่งรองรับการกำหนดเป้าหมายในอุตสาหกรรมท่องเที่ยวอื่นๆ นอกเหนือจากโรงแรม (เช่น กิจกรรมน่าสนใจ) รหัสเกณฑ์ พฤติกรรมการกำหนดเป้าหมาย และตัวปรับราคาเสนอที่มีอยู่จะยังคงเหมือนเดิม ค่าสำหรับ min_nights และ max_nights จะส่งต่อไปยัง min_days และ max_days ตามเดิม
HotelDateSelectionType และประเภทของ segments.user_set_dates	DateSelectionType	เปลี่ยนชื่อ / เปลี่ยนประเภท	ใช้ DateSelectionType แทน HotelDateSelectionType
สาเหตุของข้อผิดพลาดที่เฉพาะเจาะจงของโรงแรมใน CriterionError มีดังนี้ HOTEL_LENGTH_OF_STAY_OVERLAPS_WITH_EXISTING_CRITERION HOTEL_ADVANCE_BOOKING_WINDOW_OVERLAPS_WITH_EXISTING_CRITERION HOTEL_CHECK_IN_DATE_RANGE_OVERLAPS_WITH_EXISTING_CRITERION HOTEL_CHECK_IN_DATE_RANGE_START_DATE_TOO_EARLY HOTEL_CHECK_IN_DATE_RANGE_END_DATE_TOO_LATE HOTEL_CHECK_IN_DATE_RANGE_REVERSED	สาเหตุของข้อผิดพลาดที่ไม่ขึ้นอยู่กับประเภทธุรกิจใน CriterionError มีดังนี้ LENGTH_OF_BOOKING_OVERLAPS_WITH_EXISTING_CRITERION ADVANCE_BOOKING_WINDOW_OVERLAPS_WITH_EXISTING_CRITERION START_DATE_RANGE_OVERLAPS_WITH_EXISTING_CRITERION START_DATE_RANGE_START_DATE_TOO_EARLY START_DATE_RANGE_END_DATE_TOO_LATE START_DATE_RANGE_REVERSED	เปลี่ยนชื่อ	อัปเดตการจัดการข้อผิดพลาดเพื่อตรวจสอบสาเหตุข้อผิดพลาดใหม่ที่ไม่ขึ้นอยู่กับประเภทธุรกิจ

ฟีเจอร์และการอัปเดต (ไม่ส่งผลกระทบต่อการทำงาน)

ฟีเจอร์และการอัปเดต	ประเภท	คำอธิบาย
ชิ้นงาน
ผู้ให้บริการข้อความทางธุรกิจผ่าน LINE และ SMS	ช่องใหม่และค่า enum	เพิ่มการรองรับ LINE และ SMS เป็นผู้ให้บริการข้อความใน BusinessMessageAsset รวมถึงช่องใหม่อย่าง BusinessMessageAsset.line_info และ BusinessMessageAsset.sms_info พร้อมด้วย BusinessMessageProvider.LINE และ BusinessMessageProvider.SMS
AssetGroupError.UNSUPPORTED_LOCAL_SERVICES_CATEGORY	ค่า enum ใหม่ / ข้อผิดพลาด	เพิ่มลงใน AssetGroupError เพื่อระบุเมื่อระบบไม่รองรับหมวดหมู่ที่ระบุใน GoogleLocalServicesInfo (AssetGroup.google_local_services_info) สําหรับแคมเปญ Performance Max สำหรับบริการในพื้นที่
แคมเปญ
การสร้างแคมเปญ Performance Max สำหรับบริการในพื้นที่	ฟีเจอร์ ช่อง และข้อผิดพลาดใหม่	อัปเดต PmaxCampaignSettings.local_services_enabled จาก OUTPUT_ONLY เป็น IMMUTABLE เพื่อให้ไคลเอ็นต์ API ภายนอกระบุ local_services_enabled = true เมื่อสร้างแคมเปญ Performance Max ของโฆษณา Local Services ใหม่ นอกจากนี้ ยังเพิ่ม LocalServicesPmaxCampaignSettings.listing_id เพื่อแสดงรหัสข้อมูล Google Business Profile ที่ลิงก์กับแคมเปญ Performance Max สำหรับบริการในพื้นที่ (ทำเครื่องหมายเป็น "จำเป็น" ระหว่างการสร้างแคมเปญ Performance Max สำหรับบริการในพื้นที่) และเพิ่มรหัสข้อผิดพลาด CampaignError.INVALID_LOCAL_SERVICES_PERFORMANCE_MAX_LISTING_ID
ข้อผิดพลาดในการตรวจสอบแคมเปญบริการในพื้นที่	ค่า enum และข้อผิดพลาดใหม่	เพิ่มข้อผิดพลาดใหม่ในการตรวจสอบความถูกต้องสําหรับแคมเปญบริการในพื้นที่ ดังนี้ CampaignError: LOCAL_SERVICES_MULTIPLE_PERFORMANCE_MAX_CAMPAIGNS_NOT_ALLOWED LOCAL_SERVICES_AGREEMENT_REQUIRED AssetSetLinkError: LOCATION_ASSET_DOES_NOT_MATCH_CAMPAIGN_LISTING_ID CampaignConversionGoalError และ CampaignGoalConfigError: CANNOT_UNLINK_LOCAL_SERVICES_GOAL_FROM_LOCAL_SERVICES_CAMPAIGN GOAL_NOT_ALLOWED_FOR_LOCAL_SERVICES_CAMPAIGN LOCAL_SERVICES_GOAL_NOT_ALLOWED_FOR_NON_LOCAL_SERVICES_CAMPAIGN ConversionGoalCampaignConfigError: CANNOT_DISABLE_CAMPAIGN_OVERRIDE_GOALS_FOR_LOCAL_SERVICES_CAMPAIGN
การตรวจสอบการลิงก์บัญชี Hotel Center	ค่า enum ใหม่ / ข้อผิดพลาด	เพิ่มรหัสข้อผิดพลาด CampaignError.HOTEL_PROPERTY_ASSET_SET_HOTEL_CENTER_LINK_REQUIRED ลงใน CampaignError เพื่อระบุว่าการลิงก์ชุดชิ้นงานที่พัก (Campaign.hotel_property_asset_set) กับแคมเปญ Performance Max สำหรับเป้าหมายการท่องเที่ยวต้องใช้ลิงก์บัญชี Hotel Center ที่ใช้งานอยู่
งบประมาณขั้นต่ำต่อวันของ Demand Gen	ช่องใหม่	เพิ่มช่อง demand_gen_info.minimum_budget_per_day_micros ลงใน CurrencyConstant ซึ่งระบุงบประมาณขั้นต่ำที่จำเป็นต่อวันสำหรับแคมเปญ Demand Gen ในสกุลเงินนั้น ค่าของฟิลด์นี้จะอัปเดตเมื่องบประมาณขั้นต่ำที่ API บังคับมีการเปลี่ยนแปลง
การกำหนดค่าการวัดผลด้วย Lift สำหรับแคมเปญ	ช่องใหม่	เพิ่ม Campaign.lift_measurement_config เพื่อแสดงชื่อทรัพยากรของการกำหนดค่าการวัดผลด้วย Lift ที่ลิงก์กับแคมเปญ
การตรวจสอบการทดสอบ AI Max	ค่า enum ใหม่ / ข้อผิดพลาด	เพิ่มรหัสข้อผิดพลาด ExperimentArmError.ADOPT_AI_MAX_CAMPAIGN_ALREADY_ENABLED ลงใน ExperimentArmError เมื่อพยายามสร้างการทดสอบ ADOPT_AI_MAX สําหรับแคมเปญที่เปิดใช้ AI Max อยู่แล้ว (หรือเปิดใช้ภายในคําขอเดียวกันก่อนที่จะสร้างกลุ่มทดสอบ)
ประเภทรายการแคมเปญ Shopping	การสนับสนุนที่ครอบคลุมมากขึ้น	ขยายการรองรับ Campaign.listing_type ไปยังแคมเปญ Shopping
การปรับปรุงการประกาศด้วยตนเองเกี่ยวกับการโฆษณาด้านการเมืองในสหภาพยุโรป	ลักษณะการทำงานที่อัปเดตและช่องใหม่	ตอนนี้ Campaign.contains_eu_political_advertising เป็นตัวเลือกที่ไม่บังคับสำหรับบางแคมเปญที่ไม่ได้กำหนดเป้าหมายเชิงบวกไปยังสหภาพยุโรป ยกเว้นตามที่ระบุไว้สำหรับแคมเปญ DEMAND_GEN ที่มีการกำหนดเป้าหมายที่อัปเกรดแล้ว ฟิลด์นี้ไม่บังคับหากแคมเปญเป็นไปตามเงื่อนไขต่อไปนี้ทั้งหมดหลังจากที่ดำเนินการตามคำขอแล้ว ไม่มีเกณฑ์แคมเปญสถานที่ตั้งเชิงบวกที่อยู่ในสหภาพยุโรป ไม่มีเกณฑ์แคมเปญกลุ่มสถานที่ตั้งหรือความใกล้ชิดเชิงบวก มีเกณฑ์แคมเปญสถานที่ตั้งเชิงบวกอย่างน้อย 1 รายการที่อยู่นอกสหภาพยุโรป สําหรับแคมเปญ DEMAND_GEN ที่มี upgraded_targeting ช่องนี้จะระบุหรือไม่ก็ได้ หากกลุ่มโฆษณาที่ใช้งานอยู่ทุกกลุ่มภายในแคมเปญเป็นไปตามเงื่อนไขต่อไปนี้ทั้งหมดหลังจากดําเนินการตามคําขอแล้ว ไม่มีเกณฑ์กลุ่มโฆษณาตามสถานที่ตั้งเชิงบวกที่อยู่ภายในสหภาพยุโรป ไม่มีเกณฑ์กลุ่มโฆษณาสำหรับกลุ่มสถานที่ตั้งหรือความใกล้ชิดเชิงบวก มีเกณฑ์ของกลุ่มโฆษณาตามสถานที่ตั้งเชิงบวกอย่างน้อย 1 รายการที่อยู่นอกสหภาพยุโรป ฟิลด์นี้ยังเป็นตัวเลือกสำหรับแคมเปญที่ไม่มีกลุ่มโฆษณาที่ใช้งานอยู่ด้วย หากคำขอสร้างกลุ่มโฆษณาที่ไม่เป็นไปตามเงื่อนไขเหล่านี้ ระบบจะแสดงผล AdGroupError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION การเปลี่ยนแปลงเหล่านี้มีผลกับทั้งแคมเปญใหม่และแคมเปญที่มีอยู่ ในบางกรณี คุณจะสร้างแคมเปญใหม่ได้ก็ต่อเมื่อมีการเพิ่มเกณฑ์ในคําขอเดียวกันเท่านั้น โดยใช้ GoogleAdsService.Mutate เพื่อจัดกลุ่มการเปลี่ยนแปลง อัปเดต Campaign.missing_eu_political_advertising_declaration เพื่อให้สอดคล้องกับการเปลี่ยนแปลงใน Campaign.contains_eu_political_advertising เพิ่ม GeoTargetConstant.require_eu_political_advertising_declaration เพื่อระบุว่าสถานที่ตั้งอยู่ในหรือนอกสหภาพยุโรป เพิ่ม CampaignCriterion.require_eu_political_advertising_declaration และ AdGroupCriterion.require_eu_political_advertising_declaration แล้ว ต้องระบุ Campaign.contains_eu_political_advertising หากช่องนี้เป็น true สำหรับเกณฑ์ระดับแคมเปญภายในแคมเปญ (หรือสำหรับเกณฑ์ระดับกลุ่มโฆษณาที่ใช้งานอยู่ในแคมเปญ DEMAND_GEN ที่มีการกำหนดเป้าหมายที่อัปเกรด) ช่องจะแสดงผล true หากช่อง negative ของเกณฑ์เป็น false และเกณฑ์เป็นสถานที่ตั้งภายในสหภาพยุโรป ความใกล้ชิด (ไม่ว่าจะทับซ้อนกับเขตแดนของสหภาพยุโรปหรือไม่ก็ตาม) หรือกลุ่มสถานที่ตั้ง (ไม่ว่าจะทับซ้อนกับเขตแดนของสหภาพยุโรปหรือไม่ก็ตาม)
Conversion
การกำหนดค่า Conversion ที่ปรับปรุงแล้วแบบรวม	ฟิลด์และ Enum ใหม่	เพิ่ม ConversionTrackingSetting.enablement_setting และ ConversionTrackingSetting.effective_enablement_setting (ใน Customer.conversion_tracking_setting) เพื่อแสดงการกำหนดค่า Conversion ที่ปรับปรุงแล้วแบบรวมสำหรับบัญชี ซึ่งแสดงโดยใช้ enum EnhancedConversionsConfig ใหม่
ConversionActionCategory.MESSAGE_LEAD	ค่า enum ใหม่	เพิ่มลงใน ConversionActionCategory เพื่อรองรับการโต้ตอบทางข้อความหรือแชทที่แสดงความสนใจในข้อเสนอของผู้ลงโฆษณา
ConversionAttributionEventType.CLICK	ค่า enum ใหม่	เพิ่มลงใน ConversionAttributionEventType เพื่อแสดงถึง Conversion ที่มาจากการคลิกโฆษณา ซึ่งก่อนหน้านี้รวมอยู่ในค่า enum UNKNOWN
ทั่วไป
ข้อมูลอัปเดตเกี่ยวกับโอกาสในการขายของบริการในพื้นที่	ฟิลด์และค่า enum ใหม่	เพิ่มฟิลด์ LocalServicesLead.campaign ลงในแหล่งข้อมูล LocalServicesLead เพื่อลิงก์โอกาสในการขายกับแคมเปญที่เชื่อมโยง เพิ่ม COUPON ลงใน LocalServicesLeadType เพื่อรองรับประเภทโอกาสในการขายคูปองสําหรับบริการในพื้นที่
คำแนะนำ
คำแนะนำในการเพิ่มงบประมาณสำหรับ Search	คำแนะนำใหม่	เพิ่ม RecommendationType.RAISE_BUDGET_PERFORMANCE_TOO_LOW, Recommendation.raise_budget_performance_too_low_recommendation และ ApplyRecommendationOperation.raise_budget_performance_too_low เพื่อรองรับการเพิ่มงบประมาณเมื่องบประมาณรายวันต่ำเกินไปสําหรับแคมเปญ Search
รายงาน
การวัดผลด้วย Search Lift	ฟีเจอร์ แหล่งข้อมูล กลุ่ม และเมตริกใหม่	เพิ่มการรองรับการวัดผลด้วย Search Lift ดังนี้ เพิ่มทรัพยากรแบบอ่านอย่างเดียวใหม่ SearchLiftKeywordBundle ซึ่งแสดงกลุ่มคีย์เวิร์ดในการศึกษา Search Lift เพิ่มกลุ่มที่เลือกได้ใหม่ (segments.search_lift_keyword_bundle และ segments.search_property) และเมตริก Search Lift ใหม่ 15 รายการ (เช่น relative_search_lift, normalized_incremental_searches, search_lift_cost_micros และ search_lift_impressions) เพื่อรองรับการวิเคราะห์ Search Lift ด้วย LiftMeasurementConfig (ลิงก์กับแคมเปญที่ใช้ Campaign.lift_measurement_config) เพิ่ม enum SearchLiftKeywordBundleStatus, SearchLiftMatchingInfoSource และ SearchLiftSearchProperty
มุมมองชิ้นงาน Final URL Expansion สำหรับแคมเปญ Shopping	การสนับสนุนที่เพิ่มขึ้น	ขยาย final_url_expansion_asset_view เพื่อรองรับแคมเปญ Shopping (โดยเลือก ad_group เป็นแหล่งที่มาของการระบุแหล่งที่มาควบคู่ไปกับ final_url_expansion_asset_view.ad_group ได้)
วิดีโอ
การเปิดเผยข้อมูลเกี่ยวกับเนื้อหา Generative ของ YouTube	ช่องและ Enum ใหม่	เพิ่มการรองรับการเปิดเผยเนื้อหาที่สร้างขึ้นสำหรับการอัปโหลดบน YouTube เราได้เพิ่มฟิลด์ใหม่ YouTubeVideoUpload.video_content_metadata ประเภท VideoContentMetadata ลงใน YouTubeVideoUpload ซึ่งมีการตั้งค่าการเปิดเผยข้อมูลภายใต้ VideoContentMetadata.generative_content_disclosure ประเภท YouTubeVideoUploadGenerativeContentDisclosure

เวอร์ชันหลักและเวอร์ชันย่อย v25

Google Ads API v25 มีฟีเจอร์ใหม่ การอัปเดต และการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบดังต่อไปนี้

v25.2 (23-09-2026)

เราได้เพิ่มฟีเจอร์และการอัปเดตใหม่ต่อไปนี้ใน Google Ads API v25.2 เวอร์ชันย่อย เช่น v25.2 จะไม่มีการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ

ฟีเจอร์และการอัปเดต	ประเภท	คำอธิบาย
ชิ้นงาน
ตัวเลือก URL สำหรับ AssetGroup	ช่องใหม่	เพิ่มการรองรับตัวเลือก URL ใน AssetGroup ซึ่งช่วยให้ผู้ลงโฆษณาระบุเทมเพลตการติดตาม พารามิเตอร์ที่กำหนดเอง และคำต่อท้าย URL สุดท้ายที่ระดับกลุ่มชิ้นงานได้ ดังนี้ AssetGroup.tracking_url_template: เทมเพลต URL สำหรับสร้าง URL ติดตาม AssetGroup.url_custom_parameters: รายการการแมปที่จะใช้แทนแท็กพารามิเตอร์ที่กำหนดเองของ URL ใน tracking_url_template, final_urls หรือ final_mobile_urls AssetGroup.final_url_suffix: เทมเพลต URL สําหรับการต่อท้ายพารามิเตอร์กับ URL ของหน้า Landing Page ที่แสดงด้วยการติดตามพร้อมกัน
แคมเปญ
ข้อมูลการ Crawl วิดีโออัตโนมัติ	ฟิลด์และ Enum ใหม่	เพิ่ม AutomatedVideoCrawlSetting ลงใน Campaign.AssetAutomationSetting พร้อมกับ AssetAutomationType.AUTOMATED_VIDEO_CRAWL เพื่อให้คุณระบุการตั้งค่าการ Crawl วิดีโออัตโนมัติสําหรับแคมเปญ Performance Max ได้ AutomatedVideoCrawlSetting.automated_video_crawl_infos มีรายการของรายการ AutomatedVideoCrawlInfo แต่ละรายการจะกำหนดค่า url การ Crawl, source_platform (VideoCrawlSourcePlatform: LANDING_PAGE, SOCIAL หรือ YOUTUBE) และสถานะการเลือกใช้ enabled
ข้อผิดพลาดเกี่ยวกับตัวคูณมูลค่าการเพิ่มประสิทธิภาพวงจรของลูกค้า	ค่า enum และข้อผิดพลาดใหม่	เพิ่มสาเหตุข้อผิดพลาดในการตรวจสอบใหม่เมื่อกําหนดค่าตัวคูณมูลค่า (value_multiplier และ high_lifetime_value_multiplier) สําหรับการเพิ่มประสิทธิภาพวงจรลูกค้า ดังนี้ GoalError: HIGH_LIFETIME_VALUE_MULTIPLIER_PRESENT_BUT_VALUE_MULTIPLIER_ABSENT HIGH_LIFETIME_VALUE_MULTIPLIER_LESS_THAN_OR_EQUAL_TO_VALUE_MULTIPLIER CampaignGoalConfigError: HIGH_LIFETIME_VALUE_MULTIPLIER_PRESENT_BUT_VALUE_MULTIPLIER_ABSENT HIGH_LIFETIME_VALUE_MULTIPLIER_LESS_THAN_OR_EQUAL_TO_VALUE_MULTIPLIER CAMPAIGN_OVERRIDE_HIGH_LIFETIME_VALUE_MULTIPLIER_NOT_SUPPORTED_FOR_CAMPAIGN_TYPE
SmartCampaignSettingService.GeneratePMaxDraftCampaign	ฟีเจอร์ใหม่	เพิ่ม SmartCampaignSettingService.GeneratePMaxDraftCampaign เพื่อรองรับการสร้างแคมเปญ Performance Max ฉบับร่างจากแคมเปญอัจฉริยะที่มีอยู่ ซึ่งเริ่มต้นด้วยสถานะ CampaignStatus.PAUSED และสถานะการสร้าง CampaignCreationStatus.INCOMPLETE (ดูแปลงแคมเปญอัจฉริยะเป็นแคมเปญ Performance Max) ตั้งค่า GeneratePMaxDraftCampaignRequest.validate_only เป็น true เพื่อตรวจสอบความถูกต้องของ Conversion และรับคำเตือนการตรวจสอบหรือปัญหาเกี่ยวกับ Conversion ใน GeneratePMaxDraftCampaignResponse.validated_info โดยไม่ต้องสร้างแคมเปญฉบับร่าง (ปล่อย gbp_enabled และ image_enabled ไว้โดยไม่ตั้งค่าหรือตั้งค่าเป็น false เนื่องจากระบบยังไม่รองรับการตั้งค่าเป็น true และจะแสดงผลเป็น SmartCampaignError.GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED หรือ SmartCampaignError.IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED) GeneratePMaxDraftCampaignResponse จะแสดงชื่อทรัพยากรของเอนทิตีที่สร้างขึ้น (pmax_campaign, campaign_budget, asset_group และ assets) พร้อมกับ validated_info
Conversion
การแสดงโฆษณา Firebase	ประเภทและหมวดหมู่การกระทำที่ถือเป็น Conversion ใหม่	แสดงประเภทการกระทำที่ถือเป็น Conversion FIREBASE_ANDROID_APP_AD_IMPRESSION และ FIREBASE_IOS_APP_AD_IMPRESSION ซึ่งช่วยให้คุณเรียกข้อมูลและแก้ไขการกระทำที่ถือเป็น Conversion เหล่านี้ได้ นอกจากนี้ ยังแสดงหมวดหมู่ IN_APP_AD_REVENUE ใน ConversionActionCategory เพื่อติดตามรายได้จากการสร้างรายได้จากโฆษณาในแอปด้วย
ทั่วไป
BusinessProfileLocationSyncError	Enum และข้อผิดพลาดใหม่	เพิ่มสาเหตุของข้อผิดพลาดในการซิงค์สถานที่ตั้งของ Business Profile เมื่อซิงค์สถานที่ตั้งใน AssetSet ประเภท LOCATION_SYNC ตอนนี้ API จะแสดงผล BusinessProfileLocationSyncError พร้อมเหตุผลที่เจาะจง (EMAIL_INVALID, OAUTH_TOKEN_INVALID, ACCOUNT_REMOVED และ NO_PERMISSION_TO_ACCESS_LOCATION_ACCOUNT) แทนที่จะแสดงข้อผิดพลาด UNKNOWN ทั่วไป
การวางแผน
เมตริกเปอร์เซ็นไทล์ BenchmarksService.GenerateBenchmarksMetrics	ฟีเจอร์ใหม่	อัปเดต BenchmarksService.GenerateBenchmarksMetrics เพื่อให้เมตริกแสดงถึงสถานะการแข่งขันของลูกค้าในกลุ่มผู้ลงโฆษณารายอื่นๆ ในรูปแบบระดับเปอร์เซ็นไทล์ ระบบจะแสดงเมตริกใน PercentileMetrics ในฟิลด์ CustomerMetrics.percentile_metrics ใหม่ (ทั้งใน GenerateBenchmarksMetricsResponse.customer_metrics และ BreakdownMetrics.customer_metrics) และแสดงโดยใช้ BenchmarksCustomerPercentileTier CustomerMetrics.percentile_metrics จะแสดงก็ต่อเมื่อเป็นไปตามเงื่อนไขทั้ง 2 ข้อต่อไปนี้ใน GenerateBenchmarksMetricsRequest ต้องระบุ PERCENTILE_DATA ใน supplemental_data BenchmarksSource.all_advertisers ตั้งค่าไว้ใน benchmarks_source (ซึ่งต้องระบุ category_filter ด้วย) เพิ่มการรองรับเมตริกเปอร์เซ็นไทล์สําหรับวันที่ไตรมาสเปิดภายใน ListBenchmarksAvailableDatesResponse.supported_dates (ส่งคืนโดย BenchmarksService.ListBenchmarksAvailableDates) ในขณะที่เมตริกแบบรวมของลูกค้า (CustomerMetrics.aggregate_metrics) เมตริกอัตราของลูกค้า (CustomerMetrics.average_rate_metrics) และเมตริกเปอร์เซ็นไทล์ของลูกค้า (CustomerMetrics.percentile_metrics) ได้รับการรองรับในทุกวันที่ใน supported_dates (รวมถึงไตรมาสเปิด) เมตริกส่วนแบ่งลูกค้า (CustomerMetrics.share_metrics) และเมตริกอัตราของแหล่งที่มาของการเปรียบเทียบ (average_benchmarks_metrics เช่น average_cpm ของโฆษณา "/Apparel/Clothing") ไม่ได้รับการรองรับสําหรับไตรมาสเปิดและจะถูกละเว้นจากคําตอบ เว้นแต่ date_range ที่ขอจะอยู่ในช่วง ListBenchmarksAvailableDatesResponse.supported_dates_for_all_metrics ที่แคบกว่า เพิ่มข้อผิดพลาด BenchmarksError.NO_METRICS_FOUND ที่กำหนดเองซึ่งระบุว่าไม่พบเมตริกสำหรับชุดค่าผสมของอินพุตที่เลือกเพื่อปรับปรุงความสามารถในการใช้งาน
แฮนเดิลของช่อง YouTube สำหรับข้อมูลเชิงลึกของครีเอเตอร์	ฟีเจอร์ใหม่	อัปเดต ContentCreatorInsightsService.GenerateCreatorInsights เพื่อรองรับการค้นหาโดยใช้แฮนเดิลของช่อง YouTube โดยใช้ YouTubeChannels.youtube_channel_handles (แฮนเดิลของช่องที่ถูกต้องต้องขึ้นต้นด้วย @ เช่น @channel_handle) ตัวเลือกนี้คล้ายกับการค้นหาด้วยรหัสช่อง YouTube การตอบกลับจะมีข้อมูลเชิงลึกเกี่ยวกับครีเอเตอร์ YouTube ที่ขอ
คำแนะนำ
คำแนะนำเกี่ยวกับราคาเสนอ CPA และ ROAS	วิดีโอแนะนำใหม่	เพิ่ม Recommendation.raise_target_cpa_performance_bid_too_low_recommendation (RAISE_TARGET_CPA_PERFORMANCE_BID_TOO_LOW) และ Recommendation.lower_target_roas_performance_bid_too_low_recommendation (LOWER_TARGET_ROAS_PERFORMANCE_BID_TOO_LOW) พร้อมกับ ApplyRecommendationOperation.raise_target_cpa_performance_bid_too_low และ ApplyRecommendationOperation.lower_target_roas_performance_bid_too_low เพื่อรองรับการเพิ่ม CPA ที่ตั้งไว้หรือลด ROAS เป้าหมายเมื่อราคาเสนอต่ำเกินไปสําหรับแคมเปญ Search ในการเข้าร่วมการประมูล ดังนี้ RaiseTargetCpaPerformanceBidTooLowRecommendation มี recommended_target_multiplier (ปัจจัยที่มากกว่า 1.0) และ current_average_target_cpa_micros ให้ใช้โดยใช้ RaiseTargetCpaPerformanceBidTooLowParameters กับ target_cpa_multiplier LowerTargetRoasPerformanceBidTooLowRecommendation มี recommended_target_multiplier (ตัวประกอบที่น้อยกว่า 1.0) และ current_average_target_roas ให้ใช้ LowerTargetRoasPerformanceBidTooLowParameters กับ target_roas_multiplier
รายงาน
กลุ่มมิติข้อมูลแผนการจองโรงแรม	กลุ่มใหม่	เพิ่มกลุ่มมิติข้อมูลแผนการเดินทางและโรงแรมต่อไปนี้ลงใน Segments (เลือกได้ด้วย campaign, ad_group และ customer) Segments.advance_booking_window: ระยะเวลาการจองล่วงหน้าสำหรับแผนการเดินทางเป็นจำนวนวัน Segments.length_of_booking: ระยะเวลาการจองสำหรับแผนการเดินทางเป็นจำนวนวัน Segments.start_date: วันที่เริ่มต้นของการจองในรูปแบบ yyyy-MM-dd Segments.start_day_of_week: วันเริ่มต้นของสัปดาห์ (DayOfWeek) ของการจอง Segments.user_set_dates: ระบุว่ามีการเลือกวันที่ที่ผู้ใช้ระบุหรือไม่ (HotelDateSelectionType)
เมตริกโฆษณาแนวตั้ง	เมตริกใหม่	เพิ่มเมตริกต่อไปนี้สําหรับการรายงานโฆษณาในแนวดิ่งของโรงแรมและการเดินทางไปยัง Metrics (เลือกได้ด้วย campaign, ad_group และ customer) Metrics.vertical_ads_average_booking_value_micros: ราคาเฉลี่ยรายวันแบบถ่วงน้ำหนักตามการคลิกในหน่วยไมโคร ซึ่งรวมภาษีและค่าธรรมเนียมตลอดระยะเวลาในการเข้าพักทั้งหมดสำหรับการจองโรงแรม Metrics.vertical_ads_potential_impressions: การแสดงผลที่มีสิทธิ์ทั้งหมดที่จำกัดจำนวนการดูซึ่งพร้อมใช้งานในบริบทการค้นหา Metrics.vertical_ads_price_difference_percentage: เดลต้าเปอร์เซ็นต์ที่เปรียบเทียบราคาที่ผู้ลงโฆษณาเสนอเทียบกับราคาต่ำสุดที่แข่งขันกันสำหรับที่พักเดียวกัน
กลุ่มโฆษณาแนวตั้ง	กลุ่มใหม่	เพิ่มกลุ่มต่อไปนี้สำหรับการรายงานโฆษณาในธุรกิจโรงแรมและการท่องเที่ยวลงใน Segments (เลือกได้ด้วย campaign, ad_group และ customer) Segments.vertical_ads_price_tier: ระดับราคาของผู้ลงโฆษณา (HotelPriceBucket) เมื่อเทียบกับคู่แข่งในการประมูล Segments.vertical_ads_rate_rule_id: รหัสกฎเกี่ยวกับอัตราที่เชื่อมโยงกับกฎเกี่ยวกับอัตราของผู้ลงโฆษณา Segments.vertical_ads_rate_type: ประเภทราคา (HotelRateType) ของการจองโรงแรม

v25.1 (19-08-2026)

เราได้เพิ่มฟีเจอร์และการอัปเดตใหม่ต่อไปนี้ใน Google Ads API v25.1 เวอร์ชันย่อย เช่น v25.1 จะไม่มีการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ

ฟีเจอร์และการอัปเดต	ประเภท	คำอธิบาย
ชิ้นงาน
AssetFieldType.TEXT_DISCLAIMER ServedAssetFieldType.TEXT_DISCLAIMER	ค่า enum ใหม่	เพิ่มการรองรับชิ้นงานข้อจำกัดความรับผิดแบบข้อความ
แคมเปญ
Campaign.aca_migration_date_time Campaign.broad_match_migration_date_time	ช่องใหม่	ติดตามการย้ายข้อมูลไปยัง AI Max โดยอัตโนมัติที่กำลังจะเกิดขึ้น
Conversion
การวัด Brand Lift	ฟีเจอร์ใหม่	เพิ่มการรองรับการวัด Brand Lift พร้อมการอัปเดตต่อไปนี้ เพิ่มแหล่งข้อมูลมิติข้อมูลแบบอ่านอย่างเดียวใหม่สำหรับผลการศึกษา Brand Lift ได้แก่ LiftMeasurementAgeRange, LiftMeasurementCampaign, LiftMeasurementDevice, LiftMeasurementGender และ LiftMeasurementVideo เพิ่มกลุ่มและเมตริกใหม่เพื่อรองรับการวิเคราะห์ Brand Lift ด้วย LiftMeasurementConfig และแหล่งข้อมูลมิติข้อมูลใหม่ เพิ่ม Enum ต่อไปนี้ BrandLiftMeasurementType, LiftMeasurementFlightStatus, SurveyIntendedAction, SurveyLiftFlightTargetResponseMode และ SurveySubjectType
การวัดผลด้วย Conversion Lift	ฟีเจอร์ใหม่	เพิ่มการรองรับการวัดผลด้วย Conversion Lift พร้อมการอัปเดตต่อไปนี้ เพิ่มทรัพยากรแบบอ่านอย่างเดียวใหม่ LiftMeasurementConfig ที่แสดงถึงการศึกษา Lift เพิ่มกลุ่มใหม่ที่เลือกได้เพื่อจัดกลุ่มและกรองผลลัพธ์การเพิ่ม เพิ่มเมตริก Conversion Lift และเมตริกคะแนนผู้ชนะใหม่ 24 รายการที่รองรับการวิเคราะห์ทางสถิติโดยละเอียดเกี่ยวกับประสิทธิภาพของ Lift เพิ่มการรองรับเพื่อดึงข้อมูลรายละเอียดแคมเปญและเป้าหมาย Conversion เพิ่มฟิลด์ที่ไม่บังคับรายการใหม่ Experiment.lift_measurement_config เพิ่มการแจงนับ ConversionLiftIncludedConversionActionTypes
LiftMeasurementFlight	แหล่งข้อมูลใหม่	แหล่งข้อมูลแบบอ่านอย่างเดียวใหม่ที่แสดงรายละเอียดเที่ยวบินสำหรับการกำหนดค่าการวัด Brand Lift รวมถึงวันที่เริ่มต้นและสิ้นสุดของเที่ยวบินที่วัดผล (start_date และ end_date)
ทั่วไป
SmartCampaignError	ค่า enum ใหม่	เพิ่มรหัสข้อผิดพลาดใหม่ที่เฉพาะเจาะจงสำหรับข้อจำกัดในการสร้าง Performance Max ดังนี้ VALIDATE_ONLY_GENERATE_PMAX_NOT_SUPPORTED GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED
AuthorizationErrorEnum.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION	ค่า enum ใหม่ / ข้อผิดพลาด	แสดงเมื่อโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google Cloud ที่มีTESTระดับการเข้าถึงพยายามส่งคำขอไปยังบัญชีที่ไม่ใช่บัญชีทดสอบ
การวางแผน
ข้อมูลเชิงลึกเกี่ยวกับความรู้สึกที่มีต่อแบรนด์	ฟีเจอร์ใหม่	เพิ่มการรองรับข้อมูลเชิงลึกเกี่ยวกับความรู้สึกที่มีต่อแบรนด์ใน ContentCreatorInsightsService ดังนี้ เพิ่มข้อความ BrandSentimentInsight, SentimentInsightDistribution และ SentimentInsightSummary เพิ่ม enum Sentiment แล้ว เพิ่มค่า BRAND_SENTIMENT_DATA ลงใน enum ContentCreatorInsightsSupplementalData แล้ว เพิ่มค่า BRAND ลงใน enum InsightsKnowledgeGraphEntityCapabilities แล้ว
การปรับปรุง BenchmarksService รายการ	ฟีเจอร์ใหม่	เพิ่มการรองรับหมวดหมู่เป็นตัวกรองสำหรับการกำหนดขอบเขตการวิเคราะห์การเปรียบเทียบ นอกจากนี้ยังรองรับเมตริกที่สำคัญต่อธุรกิจเพิ่มเติมต่อไปนี้ เพิ่มตัวเลือกในการเปรียบเทียบกับผู้ลงโฆษณาทั้งหมดที่แสดงโฆษณาในหมวดหมู่ผลิตภัณฑ์และบริการอย่างน้อย 1 หมวดหมู่โดยใช้ BenchmarksService.GenerateBenchmarksMetrics และ category_filter แสดงเมตริกโฆษณาของลูกค้ามากขึ้น เช่น ต้นทุนและการดูรวมของลูกค้า และแชร์เมตริกต่างๆ เช่น share_of_voice ระบบจะแสดงเมตริกโดยใช้ AggregateMetrics และ ShareMetrics คุณสามารถดึงรายการหมวดหมู่ที่รองรับได้โดยใช้ BenchmarksService.ListBenchmarksSources กับแหล่งข้อมูลประเภท CATEGORY
การกำหนดเป้าหมายตามสถานะความเป็นบิดามารดา	ฟีเจอร์ใหม่	เพิ่มการรองรับการกำหนดเป้าหมายตามสถานะความเป็นบิดามารดาใน Reach Planner เพิ่มช่องใหม่ parental_statuses ลงใน Targeting สำหรับบริการ ReachPlanService.GenerateReachForecast และ parental_statuses ลงใน PlannableTargeting สำหรับบริการ ReachPlanService.ListPlannableProducts
คำแนะนำ
Recommendation.campaign_specific_app_goal_recommendation	คำแนะนำใหม่	แนะนำให้เพิ่มเป้าหมาย Conversion ของแอปเฉพาะแคมเปญ ระบบจะใช้ทรัพยากร EffectiveAutomaticGoal ใหม่เพื่อแสดงเป้าหมายปัจจุบันในคําแนะนํานี้
รายงาน
Metrics.original_conversion_value	ช่องใหม่	แสดงมูลค่า Conversion เดิมจาก Conversion ที่เสนอราคาได้ มูลค่านี้คือมูลค่าที่ไม่ได้ปรับของ Conversion ก่อนที่จะใช้การปรับกฎมูลค่า เช่น กฎมูลค่า Conversion หรือการปรับเป้าหมายวงจรลูกค้า
สถิติการเป็นสมาชิกโปรแกรมสะสมคะแนน	ฟีเจอร์ใหม่	เพิ่มการรองรับการแบ่งกลุ่มสถิติตามสถานะโปรแกรมการเป็นสมาชิกสะสมคะแนนของผู้ใช้ และเพิ่มมิติข้อมูลหลักของการเป็นสมาชิกสะสมคะแนนสําหรับกฎมูลค่า Conversion ดังนี้ เพิ่มกลุ่ม Segments.loyalty_membership เพื่อรองรับการแบ่งกลุ่มเมตริกการรายงานตามระดับโปรแกรมสะสมคะแนนของผู้ใช้ที่ทํา Conversion เพิ่มมิติข้อมูลหลัก LOYALTY_MEMBERSHIP เพื่อระบุว่าเมื่อใดที่เงื่อนไขการเป็นสมาชิกโปรแกรมสะสมคะแนนเป็นไปตามกฎมูลค่า Conversion
การกำหนดเป้าหมาย
vertical_ads_item_bid	ประเภทเกณฑ์ใหม่	เพิ่มประเภทเกณฑ์ vertical_ads_item_bid ใหม่ลงใน AdGroupCriterion.criterion

v25 (22-07-2026)

เราได้เพิ่มฟีเจอร์ใหม่ การอัปเดต และการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบต่อไปนี้ใน Google Ads API v25 ซึ่งเป็นการเปิดตัวเวอร์ชันหลัก

ดูคำแนะนำได้ที่อัปเกรดเป็นเวอร์ชันล่าสุด

การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ

สถานะเริ่มต้น	สถานะใหม่	ประเภทการเปลี่ยนแปลง	หลักเกณฑ์การใช้งาน
แคมเปญ
ฟิลด์แบบสแตนด์อโลน additional_value และ additional_high_lifetime_value ใน CustomerLifecycleOptimizationValueSettings	เป็นส่วนหนึ่งของ value_adjustment และ high_lifetime_value_adjustment oneof ตามลำดับ ควบคู่ไปกับฟิลด์ value_multiplier และ high_lifetime_value_multiplier ใหม่	การเปลี่ยนแปลงโครงสร้าง	อัปเดตการอ้างอิงฟิลด์เหล่านี้เนื่องจากตอนนี้เป็นส่วนหนึ่งของ Oneof แล้ว
ทรัพยากร CustomerLifecycleGoal และ CampaignLifecycleGoal เดิม บริการ CustomerLifecycleGoalService และ CampaignLifecycleGoalService ที่เกี่ยวข้อง และการตั้งค่า/Enum เดิม (CustomerAcquisitionGoalSettings, CustomerAcquisitionOptimizationModeEnum, LifecycleGoalValueSettings)	ไม่มี	การนำออก	ใช้สคีมาเป้าหมายแบบรวมที่ปรับปรุงใหม่ดังนี้ ใช้ช่อง new_customer_acquisition_goal_settings ในทรัพยากร Goal ใช้ช่อง campaign_new_customer_acquisition_settings ในทรัพยากร CampaignGoalConfig เพื่อกําหนดค่าการลบล้างเฉพาะแคมเปญ
ทั่วไป
ฟิลด์ enum ที่ซ้อนกันในข้อความคำขอและการตอบกลับของบริการสิ่งจูงใจ FetchIncentiveRequest.type Incentive.type IncentiveOffer.type	ช่อง Enum แบบสแตนด์อโลน FetchIncentiveRequest.incentive_type Incentive.incentive_type IncentiveOffer.offer_type	การเปลี่ยนชื่อ / การนำออก	ใช้ช่อง enum แบบสแตนด์อโลนใหม่แทนช่อง type เดิม
ฟิลด์ selected_incentive_id และ customer_id ที่ไม่บังคับใน ApplyIncentiveRequest	ฟิลด์ที่จำเป็น	การเปลี่ยนแปลงเชิงพฤติกรรม	ตรวจสอบว่าคุณระบุทั้ง 2 ช่องเมื่อเรียกใช้ ApplyIncentive
ช่องอีเมลของผู้บริโภค ContactDetails.email ในทรัพยากร LocalServicesLead	ไม่มี	การนำออก	นำการอ้างอิงถึงช่องนี้ออกเนื่องจากระบบไม่รองรับอีกต่อไป
ฟิลด์ allowed_domain ที่ไม่บังคับใน AdvertisingPartnerLinkInvitationProperties	ฟิลด์ที่ต้องระบุเมื่อเรียกใช้ CreateProductLinkInvitation สำหรับพาร์ทเนอร์ด้านโฆษณา	การเปลี่ยนแปลงเชิงพฤติกรรม	ตรวจสอบว่าคุณระบุ allowed_domain เมื่อสร้างคำเชิญการลิงก์ผลิตภัณฑ์สำหรับพาร์ทเนอร์ด้านโฆษณา
การวางแผน
ช่อง search_brand ใน GenerateCreatorInsightsRequest	ไม่มี	การนำออก	โปรดใช้ search_topics แทน
ฟิลด์ plannable_location_id ใน Targeting และฟิลด์ cookie_frequency_cap ใน GenerateReachForecastRequest	ไม่มี	การนำออก	เปลี่ยนไปใช้ plannable_location_ids และ cookie_frequency_cap_setting
รายงาน
ช่อง customer_metrics ใน GenerateBenchmarksMetricsResponse และ BreakdownMetrics ของประเภท Metrics	ฟิลด์ประเภท CustomerMetrics	การเปลี่ยนแปลงประเภท / การเปลี่ยนแปลงเชิงพฤติกรรม	อัปเดตการผสานรวมเพื่อใช้ประเภท CustomerMetrics ใหม่ ซึ่งมีเฉพาะเมตริกที่แสดงประสิทธิภาพโฆษณาของลูกค้า

ฟีเจอร์และการอัปเดต (ไม่ทำให้เกิดการหยุดทำงาน)

ฟีเจอร์และการอัปเดต	ประเภท	คำอธิบาย
โฆษณา
AssetAutomationType.GENERATE_ANIMATED_IMAGES_FROM_OTHER_ASSETS	ค่า enum / ลักษณะการทำงานใหม่	มีห้องว่างช่วงDemandGenMultiAssetAds หากเปิดใช้ ระบบจะสร้างภาพเคลื่อนไหวโดยใช้รูปภาพที่ไม่เคลื่อนไหวเป็นอินพุต DemandGenMultiAssetAds ใหม่จะเลือกใช้โดยค่าเริ่มต้นตั้งแต่ API เวอร์ชันนี้เป็นต้นไป
ความสามารถในการเปลี่ยนแปลงได้ของข้อมูลเนื้อหาสังเคราะห์	การเปลี่ยนแปลงพฤติกรรม	ตอนนี้ Asset.synthetic_content_info และ Ad.synthetic_content_info เปลี่ยนแปลงได้อย่างสมบูรณ์ใน v25, v24 และ v23
แคมเปญ
เป้าหมายการรักษาลูกค้าในโปรแกรมสะสมคะแนน	ฟีเจอร์ / การตั้งค่าใหม่	เพิ่มการรองรับเป้าหมายการรักษาลูกค้า ซึ่งช่วยให้ผู้ลงโฆษณาเพิ่มประสิทธิภาพแคมเปญเพื่อรักษาลูกค้าที่เป็นสมาชิกโปรแกรมสะสมคะแนนไว้ได้ เพิ่ม LOYALTY_RETENTION ลงในแจงนับ GoalType เพิ่ม CampaignGoalConfig.campaign_loyalty_retention_settings เพื่อกำหนดการตั้งค่าการคงลูกค้าไว้ตามโปรแกรมสะสมคะแนนเฉพาะแคมเปญ ซึ่งรวมถึงการปรับราคาเสนอและการแสดงสิทธิประโยชน์ของการเป็นสมาชิกในรูปแบบ PLA เพิ่ม Goal.loyalty_retention_goal_settings เพื่อกำหนดการตั้งค่าเป้าหมายการรักษาลูกค้าตามโปรแกรมสะสมคะแนนระดับบัญชี เพิ่มรหัสข้อผิดพลาดใหม่ดังนี้ LOYALTY_RETENTION_GOAL_INVALID_MODE CANNOT_USE_INCOMPATIBLE_CLO_GOALS LOYALTY_RETENTION_GOAL_ALREADY_EXISTS
เป้าหมายการได้ลูกค้าใหม่	ฟีเจอร์ / การตั้งค่าใหม่	อัปเดตการรองรับเป้าหมายการได้ลูกค้าใหม่ใน Google Ads API เพื่อให้สอดคล้องกับสคีมาเป้าหมายแบบรวมที่ปรับปรุงใหม่ ดังนี้ ขยายแหล่งข้อมูล Goal เพื่อรองรับการตั้งค่าการได้ลูกค้าใหม่โดยใช้ฟิลด์ new_customer_acquisition_goal_settings ขยายแหล่งข้อมูล CampaignGoalConfig เพื่อรองรับการลบล้างเฉพาะแคมเปญสําหรับการได้ลูกค้าใหม่โดยใช้ฟิลด์ campaign_new_customer_acquisition_settings เพิ่ม enum CustomerLifecycleOptimizationGoalSubType ใหม่เพื่อกำหนดประเภทย่อยของเป้าหมายที่รองรับ เพิ่ม NEW_CUSTOMER_ACQUISITION ลงใน enum GoalType เพิ่มสาเหตุข้อผิดพลาดในการตรวจสอบความถูกต้องใหม่ลงใน GoalError ดังนี้ NEW_CUSTOMER_ACQUISITION_GOAL_ALREADY_EXISTS เพิ่มสาเหตุใหม่ของข้อผิดพลาดในการตรวจสอบความถูกต้องใน CampaignGoalConfigError ดังนี้ CAMPAIGN_OVERRIDE_VALUES_SET_FOR_NEW_CUSTOMER_ACQUISITION_TARGET_SPECIFIC_OPTION CAMPAIGN_OVERRIDE_HIGH_LIFETIME_VALUE_NOT_SUPPORTED_FOR_CAMPAIGN_TYPE CANNOT_USE_INCOMPATIBLE_CLO_GOALS เพิ่ม ErrorDetails.incompatible_clo_goal_error_details เพื่อแสดงโครงสร้าง IncompatibleCloGoalsErrorDetails ใหม่สำหรับข้อผิดพลาดในการตรวจสอบ
Conversion
การระบุแหล่งที่มาของ Conversion ของบุคคลที่สามใน YouTube	ช่องใหม่	เพิ่มการรองรับการยืนยันการระบุแหล่งที่มาของ Conversion ของ YouTube โดยใช้พาร์ทเนอร์บุคคลที่สาม ดังนี้ เพิ่ม CustomerThirdPartyIntegrationPartners.conversion_attribution_integration_partners เพื่ออนุญาตให้กำหนดค่าพาร์ทเนอร์การรวมบริการที่ระดับลูกค้า เพิ่ม CampaignThirdPartyIntegrationPartners.conversion_attribution_integration_partners เพื่ออนุญาตให้กำหนดค่าพาร์ทเนอร์การรวมบริการที่ระดับแคมเปญ ดูข้อมูลเพิ่มเติมได้ที่บทความในศูนย์ช่วยเหลือ
ทั่วไป
ContactDetails.phone_number_extension	ช่องใหม่	เพิ่มลงในแหล่งข้อมูล LocalServicesLead แล้ว
IncentiveError	ค่า enum และข้อผิดพลาดใหม่	เพิ่มรหัสข้อผิดพลาดใหม่ที่เฉพาะเจาะจงสำหรับความล้มเหลวในการแลกรับสิ่งจูงใจ ดังนี้ BILLING_COUNTRY_NOT_ELIGIBLE (ประเทศสำหรับการเรียกเก็บเงินของลูกค้าไม่มีสิทธิ์รับสิ่งจูงใจ) USER_IS_MCC_MANAGER (ผู้ใช้เป็นบัญชีดูแลจัดการและแลกรับสิ่งจูงใจไม่ได้) USER_SUSPENDED (บัญชีลูกค้าถูกระงับ) MAX_PENDING_INCENTIVES (ลูกค้ามีสิ่งจูงใจที่รอดำเนินการครบตามจำนวนสูงสุดแล้ว) ACCOUNT_HAD_RECENT_SPEND (บัญชีมีการใช้จ่ายล่าสุดและไม่มีสิทธิ์) MAX_INCENTIVES_REDEEMED_FROM_OFFER (ลูกค้าแลกรับสิ่งจูงใจจากข้อเสนอนี้ครบจำนวนสูงสุดแล้ว) MISMATCHING_BILLING_COUNTRY_CODE (รหัสประเทศสำหรับการเรียกเก็บเงินที่ระบุในคำขอไม่ตรงกับประเทศของบัญชีลูกค้า)
การวางแผน
รายละเอียดช่อง YouTube ในข้อมูลเชิงลึกเกี่ยวกับเทรนด์	ช่องใหม่	เพิ่มการรองรับรายละเอียดช่อง YouTube เพิ่มเติมของวิดีโอที่เกี่ยวข้องเมื่อค้นหาข้อมูลเชิงลึกเกี่ยวกับเทรนด์การค้นหา เพิ่มฟิลด์ใหม่ channel_id, channel_name และ channel_url ลงใน YouTubeVideoAttributeMetadata
YouTubeChannelInsights.data_sharing_consent_given	ช่องใหม่	เพิ่มไปที่ YouTubeChannelInsights แล้ว ซึ่งจะเป็นจริงในกรณีที่ครีเอเตอร์ยินยอมให้แชร์ข้อมูลที่ไม่ใช่แบบสาธารณะ หากใช่ ระบบจะป้อนข้อมูลในช่องต่อไปนี้ average_views_per_video average_likes_per_video average_comments_per_video engagement_rate channel_audience_attributes
รายงาน
ad_sub_format_type	กลุ่มใหม่	แสดงรายละเอียดของโฆษณาในสตรีมแบบข้ามไม่ได้ของ YouTube ตามระยะเวลา INSTREAM_NON_SKIPPABLE_STANDARD (โฆษณาในสตรีมแบบข้ามไม่ได้ที่มีระยะเวลามาตรฐาน) INSTREAM_NON_SKIPPABLE_MAX30_SEC (โฆษณาในสตรีมแบบข้ามไม่ได้ที่มีความยาวไม่เกิน 30.99 วินาที) INSTREAM_NON_SKIPPABLE_MAX60_SEC (โฆษณาในสตรีมแบบข้ามไม่ได้ที่มีความยาวไม่เกิน 60.99 วินาที) ต้องเลือกกลุ่มนี้พร้อมกับ ad_format_type เสมอ โดยสามารถเลือกได้ด้วย AdGroup, AdGroupAd, Campaign, Customer, Video และ VideoEnhancement
เมตริกโซเชียลเฉพาะวิดีโอ	ช่อง / เมตริกใหม่	เพิ่มเมตริกโซเชียลสำหรับวิดีโอโดยเฉพาะเพื่อช่วยผู้ลงโฆษณาติดตามการมีส่วนร่วมของผู้ใช้ (ความคิดเห็น การกดชอบ และการแชร์) สำหรับโฆษณา Shorts บน YouTube ดังนี้ Metrics.youtube_comments Metrics.youtube_likes Metrics.youtube_shares โดยมีให้บริการใน AdGroup, AdGroupAd, Asset, Campaign, Customer และ Video

เวอร์ชันหลักและเวอร์ชันย่อย v24

Google Ads API v24 มีฟีเจอร์ใหม่ การอัปเดต และการเปลี่ยนแปลงที่ส่งผลต่อการทำงานต่อไปนี้

v24.2 (24-06-2026)

เราได้เพิ่มฟีเจอร์และการอัปเดตใหม่ต่อไปนี้ใน Google Ads API v24.2 เวอร์ชันย่อย เช่น v24.2 จะไม่มีการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ

ฟีเจอร์และการอัปเดต	ประเภท	คำอธิบาย
โฆษณา
AssetAutomationType.GENERATE_LANDING_PAGE_TEXT	ค่า enum ใหม่	สร้างข้อมูลข้อความที่สร้างขึ้นจากหน้า Landing Page เพื่อแสดงในแผงการมีส่วนร่วมสำหรับอินสแตนซ์ DemandGenVideoResponsiveAd (ซึ่งเลือกใช้โดยค่าเริ่มต้นตั้งแต่ API เวอร์ชันนี้)
ชิ้นงาน
AssetGroup.google_local_services_info	ช่องใหม่	เพิ่มเพื่อรองรับข้อมูลโฆษณาบริการในพื้นที่ (รหัสหมวดหมู่และข้อความไฮไลต์) ในแคมเปญ Performance Max
AssetGroupSignal.local_services_id	ช่องใหม่	เพิ่มเพื่อรองรับสัญญาณรหัสบริการของโฆษณาบริการในพื้นที่ในแคมเปญ Performance Max
AssetGroupSignal.vertical_ads_item_group_rule_list	ช่องใหม่	เพิ่มเพื่อรองรับกฎกลุ่มสินค้าโฆษณาวิดีโอแนวตั้งสำหรับการเลือกสินค้าจากฟีดวิดีโอแนวตั้งที่แนบมาในแคมเปญ Performance Max ฟีเจอร์นี้พร้อมใช้งานสำหรับบัญชีในรายการที่อนุญาตเท่านั้น
AssetGroupErrorEnum.CANNOT_REMOVE_ALL_ASSET_GROUPS_FROM_CAMPAIGN	ค่า enum ใหม่ / ข้อผิดพลาด	แสดงเมื่อพยายามนำกลุ่มชิ้นงานทั้งหมดออกจากแคมเปญ
AssetGroupSignalErrorEnum.CANNOT_REMOVE_ALL_SIGNALS	ค่า enum ใหม่ / ข้อผิดพลาด	แสดงผลเมื่อพยายามนําสัญญาณทั้งหมดออกจากกลุ่มชิ้นงาน
แคมเปญ
Campaign.PmaxCampaignSettings.local_services_pmax_campaign_settings Campaign.PmaxCampaignSettings.local_services_enabled	ช่องใหม่	ช่วยระบุแคมเปญ Performance Max ของบริการในพื้นที่
AdGroup.DemandGenAdGroupSettings.DemandGenChannelControls.DemandGenSelectedChannels.maps	ช่องใหม่	รวม Google Maps ไว้ในช่องทางที่เลือกได้สําหรับกลุ่มโฆษณา Demand Gen
CampaignCriterionErrorEnum.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN	ค่า enum ใหม่ / ข้อผิดพลาด	แสดงเมื่อพยายามนำสถานที่ตั้งทั้งหมดออกจากแคมเปญ Performance Max สำหรับบริการในพื้นที่
SmartCampaignErrorEnum.CREATION_FAILED	ค่า enum ใหม่ / ข้อผิดพลาด	แสดงเมื่อพยายามสร้าง Smart Campaign ใหม่
Conversion
ConversionOrigin.LOCAL_SERVICES_ADS ConversionActionType.LOCAL_SERVICES_ADS	ค่า enum ใหม่	แสดง Conversion ที่เกิดขึ้นเมื่อผู้ใช้คลิกโฆษณาบริการในพื้นที่ แล้วโทร ส่งข้อความ หรือจองกับผู้ลงโฆษณา
การทดสอบ
COMPARE_CAMPAIGNS PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION	ค่า enum ใหม่	เพิ่มการรองรับ ExperimentType ประเภทใหม่ดังนี้ COMPARE_CAMPAIGNS: สำหรับการทดสอบการผสมผสานแคมเปญและการทดสอบ Performance Max ที่กําหนดเองซึ่งเปรียบเทียบแคมเปญหลายรายการประเภทเดียวกันหรือต่างประเภทในการทดสอบเดียว PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION: สําหรับการทดสอบการเพิ่มประสิทธิภาพ Performance Max สําหรับการปรับแต่งข้อความและ Final URL Expansion
ทั่วไป
Asset.synthetic_content_info Ad.synthetic_content_info	ช่องใหม่	มีการรับรองสำหรับเนื้อหาสังเคราะห์/เนื้อหาที่ AI สร้างขึ้น โดยแบ่งออกเป็น advertiser_attestation (การประกาศที่ผู้ลงโฆษณาให้ไว้โดยตรง) และ system_attestation (การรับรองที่ระบบตรวจพบโดยอัตโนมัติหรือที่ระบบให้ไว้) ฟีเจอร์นี้ได้รับการพอร์ตย้อนหลังไปยัง v23 และ v22 แล้ว เราขอแนะนำอินเทอร์เฟซสำหรับการเปลี่ยนแปลงฟิลด์การรับรองของผู้ลงโฆษณาตั้งแต่เนิ่นๆ สำหรับ v22 ขึ้นไป เพื่อช่วยคุณวางแผนงานการผสานรวม v25 ที่กำลังจะมาถึง อินเทอร์เฟซจะปรากฏในเวอร์ชันเหล่านี้ แต่ synthetic_content_info.advertiser_attestation.status และ synthetic_content_info.advertiser_attestation.source จะยังคงไม่เปลี่ยนแปลงสำหรับเวอร์ชันเหล่านี้ หากคุณพยายามส่งคำขอเปลี่ยนแปลงข้อมูลในเซิร์ฟเวอร์ในช่องใดช่องหนึ่งเหล่านี้ ระบบจะแสดงข้อผิดพลาดอย่างใดอย่างหนึ่งต่อไปนี้ "ฟิลด์ที่พยายามแก้ไขเปลี่ยนแปลงไม่ได้" หรือ "ตั้งค่าฟิลด์ไม่ได้" ช่องเหล่านี้จะเปลี่ยนแปลงได้อย่างสมบูรณ์ตั้งแต่ v25 เป็นต้นไป เราขอแนะนำให้ใช้อินเทอร์เฟซตอนนี้เพื่อสร้างและทดสอบตรรกะภายใน เพื่อให้ระบบพร้อมสำหรับความสามารถในการเขียนแบบเต็มรูปแบบเมื่อเปิดตัว v25
การอนุมัติโดยหลายฝ่าย	ฟีเจอร์ใหม่	เบต้า: ปัจจุบันฟีเจอร์นี้ยังอยู่ในเวอร์ชันเบต้าและอาจมีการเปลี่ยนแปลงในรุ่นต่อๆ ไป เพิ่มการรองรับการตรวจสอบการอนุมัติโดยหลายฝ่าย (MPA) เพิ่มทรัพยากร MultiPartyAuthReview และ MultiPartyAuthReviewService ที่เกี่ยวข้องแล้ว เพิ่ม enum MultiPartyAuthReviewStatus เพื่อติดตามสถานะการตรวจสอบ เพิ่ม CustomerUserAccess.pending_multi_party_auth_review เพื่อลิงก์ไปยังการตรวจสอบที่รอดำเนินการ เพิ่ม MutateCustomerUserAccessResult.multi_party_auth_review และ MutateCustomerUserAccessInvitationResult.multi_party_auth_review เพื่อแสดงชื่อทรัพยากรของรีวิวที่เชื่อมโยง เพิ่ม MultiPartyAuthReviewError สำหรับข้อผิดพลาดในการตรวจสอบความถูกต้อง ฟีเจอร์นี้ได้รับการพอร์ตย้อนหลังไปยัง v23.3, v22.2 และ v21.2
IncentiveService.FetchIncentive	การเปลี่ยนแปลงเชิงพฤติกรรม	เมื่อมีการระบุอีเมลที่ไม่ถูกต้องในคำขอ ตอนนี้เมธอดจะกลับไปแสดงข้อเสนอสิ่งจูงใจเริ่มต้นอย่างราบรื่นแทนที่จะแสดงข้อผิดพลาด AuthenticationError.INVALID_EMAIL_ADDRESS
การวางแผน
GenerateCreatorInsightsRequest.search_topics	ช่องใหม่	เพิ่มไปยังบริการ ContentCreatorInsightsService.GenerateCreatorInsights แล้ว ตัวเลือกนี้จะค้นหาครีเอเตอร์ที่พูดถึงหัวข้อในประเทศที่ระบุใน country_locations (รองรับการค้นหาประเทศเดียวเท่านั้น)
CREATOR_TOPIC_INSIGHTS	ค่า enum ใหม่	เพิ่มลงใน InsightsKnowledgeGraphEntityCapabilities เพื่อระบุเอนทิตีสำหรับการค้นหาครีเอเตอร์ที่พูดถึงหัวข้อหนึ่งๆ คุณควรใช้เอนทิตีเหล่านี้ในฟิลด์ search_topics ดึงข้อมูลโดยใช้ AudienceInsightsService.ListAudienceInsightsAttributes
KnowledgeGraphEntitySearchOptions	ประเภท / ตัวเลือกใหม่	มีตัวเลือกการค้นหาเพิ่มเติมสำหรับหัวข้อใน ListAudienceInsightsAttributes รวมถึงตัวเลือกในการดึงข้อมูลหัวข้อทั้งหมดที่รองรับเป็นแอตทริบิวต์ของครีเอเตอร์ และการกรองตามความสามารถ
GenerateCreatorInsightsRequest.supplemental_data GenerateTrendingInsightsRequest.supplemental_data	ช่องใหม่	อินพุตที่ไม่บังคับสำหรับเมธอด ContentCreatorInsightsService การระบุฟิลด์นี้จะป้อนข้อมูลสถานที่ตั้งหรือแอตทริบิวต์ของผู้สร้างเพิ่มเติมในการตอบกลับ
local_creator_insights related_local_creators	ช่องใหม่	สร้างขึ้นเมื่อ supplemental_data มี enum LOCAL_CREATOR_DATA แสดงครีเอเตอร์ท้องถิ่นที่รับชมหรืออาศัยอยู่ในประเทศที่เลือก ซึ่งยินยอมให้แชร์ข้อมูลตำแหน่ง
GenerateTrendingInsightsRequest.sub_country_locations	ช่องใหม่	เพิ่มลงใน ContentCreatorInsightsService.GenerateTrendingInsights ซึ่งช่วยให้ค้นหาข้อมูลเชิงลึกเกี่ยวกับเทรนด์โดยใช้สถานที่ตั้งระดับประเทศและสถานที่ตั้งระดับย่อยในประเทศได้
รายงาน
PerformanceMaxPlacementView	ส่วนขยายกลุ่ม	ad_network_type ทำให้แบ่งกลุ่มได้
Shopping
Campaign.ShoppingSetting.ignore_brand_exclusion_in_shopping_ads	ช่องใหม่	หากเป็นจริง ระบบจะไม่สนใจการยกเว้นแบรนด์สำหรับโฆษณา Shopping รองรับเฉพาะแคมเปญ Shopping เท่านั้น
การกำหนดเป้าหมาย
CriterionErrorEnum.CANNOT_TARGET_LANGUAGE	ค่า enum ใหม่ / ข้อผิดพลาด	แสดงผลเมื่อพยายามกำหนดเป้าหมายเป็นภาษาที่ไม่อนุญาต
วิดีโอ
DataLink.youtube_link_metadata	ช่องใหม่	มี brand_channel_id เพื่อระบุรหัสของช่อง YouTube ที่ลิงก์ของแบรนด์

v24.1 (13-05-2026)

เราได้เพิ่มฟีเจอร์และการอัปเดตใหม่ต่อไปนี้ใน Google Ads API v24.1 เวอร์ชันย่อย เช่น v24.1 จะไม่มีการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ

ฟีเจอร์และการอัปเดต	ประเภท	คำอธิบาย
โฆษณา
DemandGenMultiAssetAdInfo.classic_display_images	ช่องใหม่	รูปภาพ Display ที่อัปโหลดที่กำหนดเองจะแสดงโดยไม่ต้องใช้ชิ้นงานที่ปรับเปลี่ยนตามพื้นที่โฆษณาเพิ่มเติม
การทดสอบ
ADOPT_AI_MAX ADOPT_BROAD_MATCH_KEYWORDS OPTIMIZE_ASSETS PMAX_REPLACEMENT_SHOPPING	ค่า enum ใหม่	เพิ่มการรองรับExperimentType ประเภทใหม่ดังนี้ ADOPT_AI_MAX: สำหรับการทดสอบเพื่อดูว่า AI Max ช่วยให้คุณมีส่วนร่วมกับลูกค้ามากขึ้นด้วย Google AI และคีย์เวิร์ดที่ทำงานแบบกว้างได้อย่างไร ADOPT_BROAD_MATCH_KEYWORDS: สําหรับการทดสอบที่ทดสอบว่าคีย์เวิร์ดที่ทํางานแบบกว้างส่งผลต่อจํานวนการค้นหาที่โฆษณาปรากฏอย่างไร OPTIMIZE_ASSETS: สําหรับการทดสอบที่กําหนดเองเพื่อเพิ่มประสิทธิภาพชิ้นงาน PMAX_REPLACEMENT_SHOPPING: สําหรับการทดสอบที่ทดสอบประสิทธิภาพของแคมเปญ Shopping เทียบกับ Performance Max
Experiment.video_experiment	ช่องใหม่	การสนับสนุนการกําหนดค่าสําหรับการทดสอบ YOUTUBE_CUSTOM ที่มีอยู่ซึ่งประกอบด้วยแคมเปญวิดีโอ
ExperimentArm.asset_testing_info ExperimentArm.asset_groups ExperimentArm.performance_max_experiment_arm_info	ช่องใหม่	แสดงช่องเพื่อรองรับการทดสอบชิ้นงาน กลุ่มชิ้นงาน และการตั้งค่า Performance Max ในกลุ่มทดสอบ ดังนี้ asset_testing_info: รายละเอียดของชิ้นงานที่เชื่อมโยงกับสำเนาโฆษณาเวอร์ชันทดสอบ asset_groups: รายการกลุ่มชิ้นงานในกลุ่มทดสอบสําหรับการทดสอบเพิ่มประสิทธิภาพชิ้นงาน performance_max_experiment_arm_info: การตั้งค่าแคมเปญ Performance Max ในการทดสอบ PMAX_REPLACEMENT_SHOPPING
ทั่วไป
CustomerUserAccess.passkey_enabled	ช่องใหม่	ฟิลด์แบบอ่านอย่างเดียวที่ระบุว่าผู้ใช้เปิดใช้พาสคีย์หรือไม่
รายงาน
mobile_device_platform	กลุ่มใหม่	ช่วยให้แบ่งกลุ่มรายงานตามแพลตฟอร์มของอุปกรณ์ของผู้ใช้ได้ (เช่น iOS หรือ Android)
REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED	ค่า enum ใหม่ / ข้อผิดพลาด	แสดงเมื่อระบบไม่รองรับรายละเอียดเวลาแบบรายวัน รายชั่วโมง หรือรายสัปดาห์ที่ขอสำหรับช่วงวันที่ของการค้นหา (ใช้ได้ในช่วง 37 เดือนที่ผ่านมาเท่านั้น)
vertical_ads_listing_user_rating vertical_ads_listing_venue	กลุ่มใหม่	กลุ่มใหม่ที่จะใช้สำหรับโฆษณาแนวตั้ง
user_rating, venue, event_participant_display_name	เกณฑ์ตัวกรองใหม่	รองรับการกรองใน VerticalAdsItemGroupRuleInfo สำหรับทรัพยากร SharedCriterion
เมตริกการทดสอบกลุ่มควบคุม/กลุ่มทดสอบ	ช่องใหม่	เพิ่มค่าควบคุม (control_clicks ฯลฯ), ค่าทรีตเมนต์ (clicks ฯลฯ), ค่าประมาณแบบจุด (clicks_point_estimate ฯลฯ), ส่วนต่างข้อผิดพลาด (clicks_margin_of_error ฯลฯ) และค่า p (clicks_p_value ฯลฯ) ในกลุ่มเมตริกหลัก 7 กลุ่ม (การคลิก, การแสดงผล, ต้นทุน, Conversion, ต้นทุนต่อ Conversion, มูลค่า Conversion, มูลค่า Conversion ต่อต้นทุน)
เมตริกการเปลี่ยนแปลงแบบสัมบูรณ์ของ Conversion	ช่องใหม่	รองรับConversionsการประมาณความแตกต่างสัมบูรณ์โดยใช้ฟิลด์ค่าประมาณแบบจุด ส่วนต่างความผิดพลาด และค่า p
การกำหนดเป้าหมาย
CriterionErrorEnum.CANNOT_EXCLUDE_ALL_TARGETS	ค่า enum ใหม่ / ข้อผิดพลาด	แสดงผลเมื่อพยายามยกเว้นเป้าหมายข้อมูลประชากรทั้งหมด
วิดีโอ
ThirdPartyViewabilityIntegrationPartnerEnum.ZEFR	ค่า enum ใหม่	เผยแพร่ ZEFR เป็นพาร์ทเนอร์การรวมบริการการมองเห็นโฆษณาของบุคคลที่สาม
DataLink.youtube_video.channel_id	ช่องใหม่	แสดงรหัสช่อง YouTube ที่เชื่อมโยงกับลิงก์ข้อมูล

v24 (22-04-2026)

เราได้เพิ่มฟีเจอร์ใหม่ การอัปเดต และการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นๆ ต่อไปนี้ใน Google Ads API v24 ซึ่งเป็นการเปิดตัวครั้งสำคัญ

ดูคำแนะนำได้ที่หัวข้ออัปเกรดเป็นเวอร์ชันล่าสุด

การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ

สถานะเริ่มต้น	สถานะใหม่	ประเภทการเปลี่ยนแปลง	หลักเกณฑ์การใช้งาน
โฆษณา
videos และ logo_images ไม่บังคับใน DemandGenVideoResponsiveAdInfo	ฟิลด์ที่จำเป็น	การเปลี่ยนแปลงเชิงพฤติกรรม	ระบุ videos และ logo_images เมื่อสร้างหรือเปลี่ยนแปลงโฆษณาวิดีโอ Demand Gen ที่ปรับเปลี่ยนตามพื้นที่โฆษณา
ไม่บังคับ videos, business_name และ logo_images ใน VideoResponsiveAdInfo	ฟิลด์ที่จำเป็น	การเปลี่ยนแปลงเชิงพฤติกรรม	ระบุ videos, business_name และ logo_images เมื่อสร้างหรือแก้ไขโฆษณาวิดีโอที่ปรับเปลี่ยนตามพื้นที่โฆษณา โปรดทราบว่าตอนนี้ VideoResponsiveAdInfo เปลี่ยนแปลงได้แล้ว
แคมเปญ
Campaign.video_brand_safety_suitability	ไม่มี	การนำออก	ระบบจะนำการควบคุมความเหมาะสมระดับแคมเปญออก ความเหมาะสมด้านความปลอดภัยของแบรนด์ยังคงใช้ได้ในระดับลูกค้า โปรดใช้ Customer.video_brand_safety_suitability แทน
Conversion
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS	ไม่มี	การนำออก	ระบบได้นำหมวดหมู่ผู้ใช้ที่ลงชื่อสมัครใช้โปรแกรมสะสมคะแนนออกแล้ว นำการอ้างอิงโค้ดไปยังโดเมนดังกล่าวออก
การวางแผน
ประเภท InsightsAudienceAttributeGroup สำหรับ topic_audience_combinations	ประเภท common.InsightsAudienceAttributeGroup	การเปลี่ยนแปลงเชิงพฤติกรรม / การเปลี่ยนแปลงประเภท	การผสานรวมไลบรารีของไคลเอ็นต์ที่พิมพ์ต้องได้รับการอัปเดตเพื่อใช้เนมสเปซทรัพยากรใหม่
ฟิลด์ youtube_select_lineups ใน ReachPlanService.ListPlannableProducts	ไม่มี	การนำออก	เปลี่ยนไปใช้รายการช่องจาก youtube_select_lineup_targeting
ฟิลด์ is_brand_connect_creator ใน ContentCreatorInsightsService.GenerateCreatorInsights และ GenerateTrendingInsights	ไม่มี	การนำออก	แต่ให้ตรวจสอบว่าครีเอเตอร์มี CREATOR_PARTNERSHIPS ใน partnership_opportunities หรือไม่แทน
geo_modifiers และ biddable_keywords ใน KeywordPlanIdeaService.GenerateKeywordForecastMetrics	geo_target_constants และ keywords	เปลี่ยนชื่อ / นำออก	แทนที่ด้วย CampaignToForecast.geo_target_constants[] และ ForecastAdGroup.keywords[]
ฟิลด์แผน / การคาดการณ์คีย์เวิร์ดที่เลิกใช้งานแล้วใน GenerateKeywordForecastMetrics	ไม่มี	การนำออก	นำฟิลด์และประเภทแผน / การคาดการณ์ต่อไปนี้ออก CampaignToForecast.keyword_plan_network CampaignToForecast.negative_keywords และ ForecastAdGroup.negative_keywords ForecastAdGroup.max_cpc_bid_micros BiddableKeyword CriterionBidModifier KeywordForecastMetrics.impressions KeywordForecastMetrics.click_through_rate อัปเดตการผสานรวมตามความเหมาะสม
รายงาน
ad_sub_network_type กลุ่มใน campaign_budget	ไม่มี	การนำออก	นำกลุ่ม ad_sub_network_type ออกสำหรับแหล่งข้อมูล campaign_budget
กลุ่ม click_type ในมุมมองชิ้นงาน	ไม่มี	การนำออก	นำกลุ่มออกจากมุมมอง AdGroupAsset, CampaignAsset และ CustomerAsset แล้ว
วิดีโอ
อนุญาตให้ดำเนินการไม่สำเร็จบางส่วนใน ShareablePreviewService.GenerateShareablePreviews	ไม่มีความล้มเหลวบางส่วน	การเปลี่ยนแปลงเชิงพฤติกรรม	คำขอจะดำเนินการไม่สำเร็จและแสดงข้อผิดพลาดหากรหัสใดๆ ภายในคำขอดังกล่าวไม่ผ่านการตรวจสอบความถูกต้อง
รหัสเดิมของ ShareablePreviewError: ASSET_GROUP_DOES_NOT_EXIST_UNDER_THIS_CUSTOMER TOO_MANY_ASSET_GROUPS_IN_REQUEST	MutateErrorEnum.RESOURCE_NOT_FOUND ShareablePreviewError.TOO_MANY_RESOURCES_IN_REQUEST	การเปลี่ยนชื่อ / การเปลี่ยนแปลงเชิงพฤติกรรม	รหัสข้อผิดพลาดที่แสดงผลสำหรับกลุ่มชิ้นงานได้รับการแก้ไขให้สอดคล้องกับข้อผิดพลาดของโฆษณาในกลุ่มโฆษณา อัปเดตตรรกะการตรวจจับการตรวจสอบ

ฟีเจอร์และการอัปเดต (ไม่ส่งผลกระทบต่อการทำงาน)

ฟีเจอร์และการอัปเดต	ประเภท	คำอธิบาย
โฆษณา
ความสามารถในการเปลี่ยนแปลงได้ของ VideoResponsiveAdInfo	การเปลี่ยนแปลงเชิงพฤติกรรม	ตอนนี้คุณแก้ไขออบเจ็กต์ข้อมูลโฆษณาวิดีโอที่ปรับเปลี่ยนตามพื้นที่โฆษณาได้แล้ว
ชิ้นงาน
travel_feed_data ใน AssetSet	ช่องใหม่	เพิ่มเพื่อดึงแอตทริบิวต์ชิ้นงานฟีดการท่องเที่ยว (hotel_center_account_id, merchant_center_id, partner_center_id, subset_id, travel_feed_vertical_type)
แคมเปญ
Campaign.view_through_conversion_optimization_enabled	ช่องใหม่	ช่วยให้เปิดใช้การเพิ่มประสิทธิภาพ Conversion การดูผ่าน (VTC) (ค่าเริ่มต้น false) ในแคมเปญ Demand Gen และ App Campaign ได้
CampaignCriterion.gender	ฟีเจอร์ใหม่	เปิดใช้การยกเว้นเพศสำหรับแคมเปญ Performance Max ใน Google Ads API ทุกเวอร์ชัน
Conversion
ประเภท Conversion ของ Lead Gen	ค่า enum ใหม่	เพิ่ม enum ประเภทการกระทำที่ถือเป็น Conversion ใหม่ของ GA4/Firebase ใน ConversionActionType: GOOGLE_ANALYTICS_4_GENERATE_LEAD GOOGLE_ANALYTICS_4_QUALIFY_LEAD GOOGLE_ANALYTICS_4_CLOSE_CONVERT_LEAD FIREBASE_ANDROID_GENERATE_LEAD FIREBASE_ANDROID_QUALIFY_LEAD FIREBASE_ANDROID_CLOSE_CONVERT_LEAD FIREBASE_IOS_GENERATE_LEAD FIREBASE_IOS_QUALIFY_LEAD FIREBASE_IOS_CLOSE_CONVERT_LEAD
ทั่วไป
UserListErrorEnum.DUPLICATE_LOOKALIKE	ค่า enum ใหม่ / ข้อผิดพลาด	แสดงผลเมื่อพยายามสร้างกลุ่มเป้าหมายที่คล้ายกันหลายกลุ่มที่เหมือนกัน
การวางแผน
ProductCoreAttributes ช่องใน ListPlannableProductsResponse	ช่องใหม่	เพิ่มรายละเอียดผลิตภัณฑ์ที่วางแผนได้ วัตถุประสงค์ทางการตลาด รูปแบบต้นทุน และวิธีการซื้อลงใน ProductCoreAttributes ในส่วนListPlannableProductsResponse
รายงาน
CartDataSalesView	แหล่งข้อมูลการรายงานใหม่	แสดงรายงานที่แบ่งกลุ่มเมตริก Conversion ตามสินค้าที่เฉพาะเจาะจงที่ขาย (แบรนด์ ฯลฯ) นอกเหนือจากผลิตภัณฑ์ที่คลิก
เมตริกที่ไม่รวมในการเสนอราคา	ช่องใหม่	เพิ่มเมตริกที่ไม่รวมในการเสนอราคา (เมตริกที่แสดง Conversion ที่แคมเปญไม่ได้เพิ่มประสิทธิภาพ) ลงในแหล่งข้อมูลที่ตรงกันทั้งหมด ดังนี้ all_average_cart_size all_average_order_value_micros all_cost_of_goods_sold_micros all_cross_sell_cost_of_goods_sold_micros all_cross_sell_gross_profit_micros all_cross_sell_revenue_micros all_cross_sell_units_sold all_gross_profit_margin all_gross_profit_micros all_lead_cost_of_goods_sold_micros all_lead_gross_profit_micros all_lead_revenue_micros all_lead_units_sold all_orders all_revenue_micros all_units_sold
conversion_attribution_event_type	กลุ่มใหม่	เพิ่มไปที่ ShoppingPerformanceView แล้ว
Shopping
App Campaign ใน ShoppingProduct	ฟีเจอร์ใหม่	App Campaign ที่รองรับภายในแหล่งข้อมูล ShoppingProduct ระบบไม่รองรับสถานะและปัญหาของหมายเหตุ
การกรองผลิตภัณฑ์ตามแท็ก	ฟีเจอร์ใหม่	เปิดตัวการกรองโดยใช้การแสดงตรรกะแบบไดนามิก เพิ่มประเภทเกณฑ์ RETAIL_FILTER_BUNDLE และ RETAIL_FILTER เพิ่มประเภทชุดที่แชร์ RETAIL_FILTER เพิ่มฟิลด์ retail_filter_bundle ลงใน AdGroupCriterion แล้ว เพิ่มฟิลด์ retail_filter ลงใน SharedCriterion แล้ว เพิ่ม RETAIL ไปยัง ListingGroupFilterListingSource แล้ว เพิ่มมิติข้อมูล RetailFilter ไปยัง AssetGroupListingGroupFilter แล้ว เพิ่มข้อผิดพลาดใหม่ในการตรวจสอบที่เกี่ยวข้องใน CriterionError และ AssetGroupListingGroupFilterError ฟีเจอร์นี้ใช้ได้กับบัญชีในรายการที่อนุญาตเท่านั้น

เวอร์ชันหลักและเวอร์ชันย่อยของ v23

Google Ads API v23 มีฟีเจอร์ใหม่ การอัปเดต และการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบต่อไปนี้

v23.3 (24-06-2026)

เราได้เพิ่มฟีเจอร์และการอัปเดตใหม่ๆ ต่อไปนี้ใน Google Ads API v23.3 เวอร์ชันย่อย เช่น v23.3 จะไม่มีการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ

ฟีเจอร์และการอัปเดต	ประเภท	คำอธิบาย
ทั่วไป
Asset.synthetic_content_info Ad.synthetic_content_info	ช่องใหม่	มีการรับรองสำหรับเนื้อหาสังเคราะห์/เนื้อหาที่ AI สร้างขึ้น โดยแบ่งออกเป็น advertiser_attestation (การประกาศที่ผู้ลงโฆษณาให้ไว้โดยตรง) และ system_attestation (การรับรองที่ระบบของ Google ตรวจพบโดยอัตโนมัติหรือได้รับจากระบบของ Google) เราจะเปิดตัวอินเทอร์เฟซสําหรับการเปลี่ยนแปลงช่องการรับรองของผู้ลงโฆษณาก่อนกําหนดสําหรับ v22 ขึ้นไป เพื่อช่วยคุณวางแผนงานการผสานรวมที่กําลังจะเกิดขึ้นสําหรับ v25 อินเทอร์เฟซจะปรากฏในเวอร์ชันเหล่านี้ แต่ synthetic_content_info.advertiser_attestation.status และ synthetic_content_info.advertiser_attestation.source จะ ยังคงไม่เปลี่ยนแปลงสำหรับเวอร์ชันเหล่านี้ หากคุณพยายามส่งคำขอเปลี่ยนแปลงข้อมูลในเซิร์ฟเวอร์ในช่องใดช่องหนึ่งเหล่านี้ ระบบจะแสดงข้อผิดพลาดอย่างใดอย่างหนึ่งต่อไปนี้ "ฟิลด์ที่พยายามแก้ไขเปลี่ยนแปลงไม่ได้" หรือ "ตั้งค่าฟิลด์ไม่ได้" ช่องเหล่านี้จะเปลี่ยนแปลงได้อย่างสมบูรณ์ตั้งแต่ v25 เป็นต้นไป เราขอแนะนำให้ใช้อินเทอร์เฟซตอนนี้เพื่อสร้างและทดสอบตรรกะภายใน เพื่อให้ระบบพร้อมสำหรับความสามารถในการเขียนแบบเต็มรูปแบบเมื่อเปิดตัว v25
การอนุมัติจากผู้ที่มีสิทธิ์	ฟีเจอร์ใหม่	เบต้า: ปัจจุบันฟีเจอร์นี้ยังอยู่ในเวอร์ชันเบต้าและอาจมีการเปลี่ยนแปลงในรุ่นต่อๆ ไป เพิ่มการรองรับการตรวจสอบการอนุมัติจากผู้ที่มีสิทธิ์ (MPA) ดังนี้ เพิ่มทรัพยากร MultiPartyAuthReview และ MultiPartyAuthReviewService ที่เกี่ยวข้องแล้ว เพิ่ม enum MultiPartyAuthReviewStatus เพื่อติดตามสถานะการตรวจสอบ เพิ่ม CustomerUserAccess.pending_multi_party_auth_review เพื่อลิงก์ไปยังการตรวจสอบที่รอดำเนินการ เพิ่ม MutateCustomerUserAccessResult.multi_party_auth_review และ MutateCustomerUserAccessInvitationResult.multi_party_auth_review เพื่อแสดงชื่อทรัพยากรการตรวจสอบที่เกี่ยวข้อง เพิ่ม MultiPartyAuthReviewError สำหรับข้อผิดพลาดในการตรวจสอบความถูกต้อง

v23.2 (25-03-2026)

เราได้เพิ่มฟีเจอร์และการอัปเดตใหม่ต่อไปนี้ใน Google Ads API v23.2 เวอร์ชันย่อย เช่น v23.2 จะไม่มีการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ

ฟีเจอร์และการอัปเดต	ประเภท	คำอธิบาย
ชิ้นงาน
VideoEnhancement	แหล่งข้อมูลใหม่	มีข้อมูลโฆษณาวิดีโอที่เฉพาะเจาะจงสำหรับการเพิ่มประสิทธิภาพ เช่น ข้อมูลที่ Google สร้างขึ้นหรือผู้ลงโฆษณาให้ไว้ ดูข้อมูลเพิ่มเติมได้ที่เกี่ยวกับการเพิ่มประสิทธิภาพวิดีโอ
AppTopCombinationView	แหล่งข้อมูลใหม่	แหล่งข้อมูลแบบอ่านอย่างเดียวเพื่อให้ข้อมูลเชิงลึกเกี่ยวกับชุดค่าผสมของชิ้นงานที่มีประสิทธิภาพสูงสุดใน App Campaign
CustomerAsset	ฟีเจอร์ใหม่	เพิ่มการรองรับการดึงข้อมูล CustomerAsset โดยตั้งค่า field_type เป็น BUSINESS_LOGO
แคมเปญ
AdGroupAd.start_date_time AdGroupAd.end_date_time	ช่องใหม่	ระบุข้อจํากัดในการจัดตารางเวลาที่ละเอียดยิ่งขึ้นในช่วงวันที่ของแคมเปญ ระบบรองรับการดำเนินการนี้สำหรับกลุ่มโฆษณาบางประเภทเท่านั้น
HotelSettingInfo.disable_hotel_setting	ช่องใหม่	อนุญาตให้ปิดใช้ฟีดโรงแรมในแคมเปญ Demand Gen
ทั่วไป
CustomerClientLinkError	ค่า enum / ข้อผิดพลาดใหม่	เพิ่มรหัสข้อผิดพลาดใหม่ 2 รายการ ได้แก่ MAX_CUSTOMER_LIMIT_REACHED และ ACCOUNT_CREATION_POLICY_VIOLATION
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS	การเปลี่ยนแปลงพฤติกรรม	ตอนนี้ระบบจะแสดงข้อผิดพลาดเมื่อพยายามใช้หมวดหมู่ประเภทลูกค้าในรายชื่อผู้ใช้ที่เลิกใช้งานแล้วนี้
การวางแผน
GenerateTrendingInsights GenerateCreatorInsights	ฟีเจอร์ใหม่	เพิ่มการรองรับการรวมเอนทิตี หัวข้อ และกลุ่มเป้าหมายแบบ AND/OR ที่กำหนดเอง
ReachPlanService.GenerateReachForecast	ค่า enum ใหม่	เพิ่มช่วงอายุใหม่ที่กำหนดเป้าหมายได้ เช่น AGE_RANGE_21_44 หรือ AGE_RANGE_21_49
youtube_select_lineup_targeting	ช่องใหม่	เพิ่มไปยัง ReachPlanService.ListPlannableProducts แล้ว ซึ่งจะแทนที่ youtube_select_lineups ปัจจุบันทั้ง 2 ช่องมีข้อมูลอยู่
ReachPlanSurface	ค่า enum ใหม่	เพิ่ม IN_STREAM_NON_SKIPPABLE_THIRTY_SECONDS เป็นตัวเลือกแพลตฟอร์มแล้ว
Forecast	ช่องใหม่	เพิ่ม clicks สำหรับคลิกสูงสุด (CPC) ของ Demand Gen ใน ReachPlanService.GenerateReachForecast
partnership_opportunities	ช่องใหม่	เพิ่มไปยัง ContentCreatorInsightsService.GenerateCreatorInsights และ ContentCreatorInsightsService.GenerateTrendingInsights แล้ว
รายงาน
biddable_indirect_install_first_in_app_conversion_micros	ช่องใหม่	เพิ่มไปยังแหล่งข้อมูล Campaign, Customer และ AdGroup แล้ว
วิดีโอ
ShareablePreviewService	ฟีเจอร์ใหม่	ขยายเพื่อรองรับตัวอย่าง YouTube Live โดยตั้งค่า preview_type เป็น YOUTUBE_LIVE_PREVIEW เพิ่ม UNSUPPORTED_AD_TYPE และ TOO_MANY_RESOURCES_IN_REQUEST ไปยัง ShareablePreviewError แล้ว รองรับเฉพาะประเภทโฆษณาบางประเภทเท่านั้น

v23.1 (25-02-2026)

เราได้เพิ่มฟีเจอร์และการอัปเดตใหม่ต่อไปนี้ใน Google Ads API v23.1 เวอร์ชันย่อย เช่น v23.1 จะไม่มีการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ

ฟีเจอร์และการอัปเดต	ประเภท	คำอธิบาย
การจัดการบัญชี
advertising_partner_properties.allowed_domain	ช่องใหม่	เพิ่มลงในแหล่งข้อมูล ProductLinkInvitation และ ProductLink แล้ว พาร์ทเนอร์ด้านโฆษณาจะลงโฆษณาได้เฉพาะในโดเมนนี้เท่านั้น
Customer.contains_eu_political_advertising	ช่องใหม่	ดึงข้อมูลสถานะการประกาศระดับบัญชีว่ามีการโฆษณาด้านการเมืองที่กำหนดเป้าหมายไปยังสหภาพยุโรปหรือไม่ และแสดงผล EuPoliticalAdvertisingStatus
แคมเปญ
Campaign.text_guidelines	ช่องใหม่	เพิ่มการรองรับหลักเกณฑ์เกี่ยวกับข้อความ ซึ่งใช้ได้กับแคมเปญ Performance Max และ Search เพื่อควบคุมชิ้นงานข้อความที่ AI สร้างขึ้นโดยอัตโนมัติ คุณสามารถกำหนด term_exclusions และ messaging_restrictions ได้ภายใน text_guidelines
CampaignPrimaryStatusReason	ค่า enum ใหม่	เพิ่ม CAMPAIGN_NOT_BOOKED, BOOKING_HOLD_EXPIRING, BOOKING_HOLD_EXPIRED และ BOOKING_CANCELLED เพื่อระบุเหตุผลหลักของสถานะสําหรับแคมเปญที่ใช้กลยุทธ์การเสนอราคา FIXED_CPM
Campaign.VideoCampaignSettings.reservation_ad_category_self_disclosure Campaign.VideoCampaignSettings.booking_details	ช่องใหม่	เพิ่มการรองรับการเปิดเผยข้อมูลด้วยตนเองเกี่ยวกับหมวดหมู่โฆษณาแบบจองล่วงหน้าและรายละเอียดการจองแบบอ่านอย่างเดียว
Campaign.missing_eu_political_advertising_declaration	ช่องใหม่	รองรับการค้นหาและการกรองแคมเปญที่ไม่มีประกาศว่ามีโฆษณาทางการเมืองที่กำหนดเป้าหมายไปยังสหภาพยุโรปหรือไม่
Conversion
ConversionActionCategory.YOUTUBE_FOLLOW_ON_VIEWS	ค่า enum ใหม่	รองรับการติดตามผู้ใช้ที่ดูโฆษณาและต่อมาดูวิดีโอจากช่องเดียวกัน
ทั่วไป
CriterionErrorEnum.CANNOT_TARGET_ONLY_UNDETERMINED	ค่า enum ใหม่ / ข้อผิดพลาด	แสดงผลเมื่อพยายามกำหนดเป้าหมายเฉพาะหมวดหมู่ที่ไม่ได้กำหนดในมิติข้อมูลประชากร
สิ่งจูงใจ
IncentiveErrorEnum	ค่า enum / ข้อผิดพลาดใหม่	เพิ่มรหัสข้อผิดพลาดใหม่ 2 รายการ ได้แก่ MAX_INCENTIVES_REDEEMED และ ACCOUNT_TOO_OLD ข้อผิดพลาดเหล่านี้อาจแสดงขึ้นสำหรับคำขอที่ส่งในวันที่ 11 มีนาคม 2026 หรือหลังจากนั้น
การวางแผน
GenerateBenchmarksMetrics	ฟีเจอร์ใหม่	เพิ่มการรองรับรายละเอียดวันที่โดยใช้ BreakdownDefinition
ReachPlanService.GenerateReachForecast	ค่า enum ใหม่	เพิ่ม GOOGLE_DISPLAY_NETWORK เป็นแพลตฟอร์มที่กำหนดเป้าหมายได้สำหรับจำนวน Conversion สูงสุดของ Demand Gen
GenerateTrendingInsights	ช่องใหม่	เพิ่มข้อมูลเส้นแนวโน้มที่ผ่านมาใน TrendInsightDataPoint ไปยัง TrendInsights เมื่อค้นหาตามหัวข้อ
รายงาน
เมตริกความถี่ของผู้ใช้ที่ไม่ซ้ำ	ช่องใหม่	เพิ่มเมตริกใหม่ที่รายงานจำนวนผู้ใช้ที่เห็นโฆษณาของคุณอย่างน้อย 2, 3, 4, 5 หรือ 10 ครั้ง ได้แก่ unique_users_two_plus, unique_users_three_plus, unique_users_four_plus, unique_users_five_plus และ unique_users_ten_plus
SearchTermMatchSource	ค่า enum ใหม่	เพิ่ม VERTICAL_ADS_DATA_FEED เพื่อรองรับฟีดข้อมูลในบริบทโฆษณาเฉพาะหมวดหมู่ เช่น การกำหนดเป้าหมายเอนทิตีโฆษณาการเดินทาง
YouTubeVideoUpload
YouTubeVideoUpload	บริการ / แหล่งข้อมูลใหม่	เพิ่มบริการ YouTubeVideoUpload เพื่อรองรับการอัปโหลดและจัดการวิดีโอบน YouTube และเพิ่มทรัพยากร YouTubeVideoUpload เพื่อรองรับการดึงข้อมูลสถานะการอัปโหลดและข้อมูลเมตา ฟีเจอร์นี้รองรับเฉพาะ REST และไลบรารีไคลเอ็นต์ Python

v23 (28-01-2026)

เราได้เพิ่มฟีเจอร์ใหม่ การอัปเดต และการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบต่อไปนี้ใน Google Ads API v23 ซึ่งเป็นการเปิดตัวเวอร์ชันหลัก

ดูคำแนะนำได้ที่หัวข้ออัปเกรดเป็นเวอร์ชันล่าสุด

การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ

สถานะเริ่มต้น	สถานะใหม่	ประเภทการเปลี่ยนแปลง	หลักเกณฑ์การใช้งาน
โฆษณา
อนุญาตให้แชร์โฆษณา	AdGroupAdError.AD_SHARING_NOT_ALLOWED	การเปลี่ยนแปลงเชิงพฤติกรรม	ไม่อนุญาตให้แชร์โฆษณาระหว่างกลุ่มโฆษณาหลายกลุ่มอีกต่อไป คำขอที่พยายามแชร์โฆษณาจะแสดงข้อผิดพลาด AD_SHARING_NOT_ALLOWED
การสนับสนุนสำหรับ CallAd และ CallAdInfo	ไม่มี	การนำออก	เราได้นําการรองรับโฆษณาแบบโทรออกแล้ว ดูบทความในศูนย์ช่วยเหลือเกี่ยวกับโฆษณาแบบโทร
แคมเปญ
Campaign.start_date Campaign.end_date	Campaign.start_date_time Campaign.end_date_time	เปลี่ยนชื่อ / แทนที่	ใช้ฟิลด์วันที่และเวลาใหม่เพื่อระบุคอมโพเนนต์เวลาสําหรับแคมเปญ ระบบจะนำช่องวันที่เท่านั้นเดิมออก
Demand Gen
DemandGenMultiAssetAdInfo.lead_form_only	ไม่มี	การนำออก	นำช่อง lead_form_only ออกแล้ว อัปเดตการอ้างอิงในโค้ด
รายงาน
เมตริกและ Enum ของป้ายกำกับประสิทธิภาพของเนื้อหาแบบรวม	ไม่มี	การนำออก	นำเมตริกป้ายกำกับประสิทธิภาพของชิ้นงานแบบรวมออก ระบบจะไม่แสดงผลการแจงนับป้ายกํากับประสิทธิภาพสําหรับ Search และ Display อีกต่อไป

ฟีเจอร์และการอัปเดต (ไม่ทำให้เกิดการหยุดทำงาน)

ฟีเจอร์และการอัปเดต	ประเภท	คำอธิบาย
โฆษณา
AdFormatType	ค่า enum ใหม่	เพิ่มประเภทรูปแบบใหม่ ได้แก่ TEXT, VERTICAL_ADS_BOOKING_LINK และ VERTICAL_ADS_PROMOTION
ชิ้นงาน
มุมมอง asset_group	ช่องใหม่	เพิ่มเมตริกต่อไปนี้ metrics.engagements, metrics.engagement_rate และ metrics.average_cpe
ยอดดู asset_group_asset ครั้ง	ช่องใหม่	เพิ่มเมตริกต่อไปนี้ metrics.average_cpe, metrics.average_cpm, metrics.trueview_average_cpv, metrics.video_trueview_view_rate, metrics.video_trueview_views และ metrics.interaction_event_types
Asset.orientation	ช่องใหม่	เพิ่มฟิลด์การวางแนวแบบอ่านอย่างเดียวลงในชิ้นงานรูปภาพและชิ้นงานวิดีโอ
CampaignAsset	ฟีเจอร์ใหม่	เพิ่มการรองรับเพื่อดึงข้อมูลชิ้นงานของแคมเปญโดยตั้งค่า field_type เป็น HEADLINE และ DESCRIPTION
ServedAssetFieldType	ค่า enum ใหม่	เพิ่ม HEADLINE_AS_SITELINK_POSITION_ONE, HEADLINE_AS_SITELINK_POSITION_TWO, DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_ONE และ DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_TWO สำหรับชิ้นงานที่แสดงเป็นไซต์ลิงก์
BusinessMessageAsset	ฟีเจอร์ใหม่ / การสนับสนุน	ชิ้นงานข้อความถึงธุรกิจที่อัปเดตแล้ว เพิ่มการรองรับ Facebook Messenger และ Zalo เป็นผู้ให้บริการ เพิ่ม FACEBOOK_MESSENGER และ ZALO ไปยัง BusinessMessageProvider แล้ว เพิ่มฟิลด์ facebook_messenger_info และ zalo_info แล้ว เพิ่ม CUSTOMER_NOT_ON_ALLOWLIST_FOR_MESSAGE_ASSETS ไปยัง AssetError แล้ว
การเรียกเก็บเงิน
InvoiceService.ListInvoices	ตัวเลือกใหม่	ตอนนี้สามารถแสดงรายละเอียดที่ละเอียดยิ่งขึ้นใน Invoice ได้แล้ว ซึ่งรวมถึงรายละเอียดค่าใช้จ่ายระดับแคมเปญ ค่าใช้จ่ายตามกฎระเบียบที่แยกรายการ และข้อมูลการปรับค่าใช้จ่าย โดยการตั้งค่า include_granular_level_invoice_details ใน ListInvoicesRequest
RegulatoryFeeType UnitOfMeasure	enum ใหม่	เพิ่ม Enum ตัวช่วยสำหรับค่าธรรมเนียมที่ต้องชำระตามกฎหมายและหน่วยวัด
แคมเปญ
CampaignError	ค่า enum / ข้อผิดพลาดใหม่	เพิ่มรหัสข้อผิดพลาด DURATION_TOO_LONG_FOR_TOTAL_BUDGET และ END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET
Conversion
ConversionActionCategory	ค่า enum ใหม่	เพิ่ม YOUTUBE_FOLLOW_ON_VIEWS เพื่อรองรับการติดตามผู้ใช้ที่ดูโฆษณาและดูวิดีโอจากช่องเดียวกันในภายหลัง
Demand Gen
DemandGenVideoResponsiveAdInfo.companion_banner	ช่องใหม่	เพิ่มการรองรับแบนเนอร์ที่แสดงร่วมกันในโฆษณาวิดีโอ Demand Gen ที่ปรับเปลี่ยนตามพื้นที่โฆษณา
สิ่งจูงใจ
เพิ่มการรองรับสิ่งจูงใจแบบเลือกเอง (CYO) ดังนี้ เพิ่มเมธอด FetchIncentive เพื่อดึงข้อมูลสิ่งจูงใจที่ปรับเปลี่ยนในแบบของคุณที่พร้อมใช้งานสำหรับผู้ใช้ เพิ่มเมธอด ApplyIncentive เพื่อใช้สิ่งจูงใจที่เลือกกับบัญชีลูกค้า เพิ่มทรัพยากร AppliedIncentive (ค้นหาได้โดยใช้ Search และ SearchStream) เพื่อระบุรายละเอียดการแลกสิทธิ์ เพิ่มรหัสข้อผิดพลาดใหม่ใน IncentiveError และ AuthenticationError.INVALID_EMAIL_ADDRESS เราจะเพิ่มรหัสข้อผิดพลาดเพิ่มเติมใน IncentivesService ในรุ่นต่อๆ ไป เพื่อให้จัดการความล้มเหลวแบบเป็นโปรแกรมได้ละเอียดยิ่งขึ้น เราขอแนะนำให้คุณติดตามประกาศและบันทึกประจำรุ่นที่กำลังจะมาถึงสำหรับรหัสข้อผิดพลาดใหม่เหล่านี้ เพื่อให้แน่ใจว่าแอปพลิเคชันของคุณจะจัดการโหมดความล้มเหลวใหม่เหล่านี้ได้
การวางแผน
AudienceInsightsDimension.LIFE_EVENT_USER_INTEREST	ค่า enum ใหม่	อนุญาตให้สร้างกลุ่มเป้าหมายโดยใช้เหตุการณ์สำคัญในชีวิตใน GenerateAudienceCompositionInsights, GenerateSuggestedTargetingInsights, GenerateInsightsFinderReport และ GenerateCreatorInsights AudienceInsightsService วิธีอื่นๆ เช่น AudienceInsightsService.GenerateAudienceOverlap และ AudienceInsightsService.GenerateTargetingSuggestionMetrics ไม่รองรับเหตุการณ์สำคัญในชีวิต
ReachPlanService.GenerateConversionRates	ช่อง / ตัวเลือกใหม่	ตอนนี้การตอบกลับจะมีแพลตฟอร์มเพื่อรองรับคำแนะนำเกี่ยวกับอัตรา Conversion ตามการควบคุมแพลตฟอร์ม (เช่น Gmail, Shorts) รองรับเฉพาะแคมเปญ Demand Gen เท่านั้น
LanguageDistribution	ฟิลด์ / ประเภทใหม่	เพิ่มลงใน YouTubeChannelInsights เพื่อให้รายละเอียดการเผยแพร่ภาษาในเนื้อหาของช่อง YouTube
BenchmarksService	บริการใหม่	เปรียบเทียบข้อมูลโฆษณาบน YouTube กับการเปรียบเทียบในธุรกิจเดียวกัน
AudienceInsightsService.GenerateAudienceDefinition	วิธีการใหม่	แปลคำอธิบายข้อความอิสระของกลุ่มเป้าหมายเป็นแอตทริบิวต์กลุ่มเป้าหมายที่ตรงกันโดยใช้ Generative AI
YouTubeChannelInsights.relevance_score	ช่องใหม่	ประเมินความเกี่ยวข้องของครีเอเตอร์กับหัวข้อโดยพิจารณาจากยอดดู
TrendInsightMetrics.trend_change_percent	ช่องใหม่	แสดงเปอร์เซ็นต์การเปลี่ยนแปลงของมูลค่าเทรนด์ในช่วงระยะเวลาเปรียบเทียบ
คำแนะนำ
GenerateRecommendationsRequest	ช่องใหม่	เพิ่ม is_new_customer แล้ว เมื่อตั้งค่าเป็น true สําหรับคําแนะนํา CAMPAIGN_BUDGET ระบบจะใช้โมเดลที่เพิ่มประสิทธิภาพสําหรับลูกค้าใหม่ (แนะนําสําหรับลูกค้าที่ไม่มีแคมเปญเท่านั้น)
รายงาน
AdGroupAdAssetView	การรองรับฟีเจอร์ / เมตริกใหม่	ตอนนี้รองรับเมตริกการแสดงผล ประสิทธิภาพ และ Conversion สำหรับ RESPONSIVE_DISPLAY_AD แล้ว
ad_sub_network_type กลุ่ม	กลุ่มใหม่	แสดงรายละเอียดประสิทธิภาพแบบละเอียดภายในเครือข่ายโฆษณา ในระยะแรกจะพร้อมใช้งานสําหรับแคมเปญ Demand Gen บน YouTube (ในสตรีม, ในฟีด, Shorts) ต้องเลือกพร้อมกับ ad_network_type
การรายงาน Performance Max	ฟีเจอร์ใหม่	รายละเอียดประเภทเครือข่ายโฆษณาที่เปิดใช้สําหรับแคมเปญ Performance Max
UserLocationView GeographicView	การรองรับกลุ่มใหม่	เมตริกที่รองรับซึ่งแบ่งกลุ่มตามวันที่เกิด Conversion ได้แก่ conversions_by_conversion_date, all_conversions_by_conversion_date, conversions_value_by_conversion_date, all_conversions_value_by_conversion_date, value_per_conversions_by_conversion_date, value_per_all_conversions_by_conversion_date, cross_device_conversions_by_conversion_date และ cross_device_conversions_value_by_conversion_date
กลุ่มโฆษณาแนวตั้ง	กลุ่มใหม่	เพิ่มกลุ่มต่อไปนี้แล้ว: vertical_ads_event_participant_display_names, vertical_ads_hotel_class, vertical_ads_listing, vertical_ads_listing_brand, vertical_ads_listing_city, vertical_ads_listing_country, vertical_ads_listing_region, vertical_ads_partner_account และ vertical_ads_vertical
PerStoreView MatchedLocationInterestView	แหล่งข้อมูลการรายงานใหม่	เพิ่ม PerStoreView เพื่อค้นหารายละเอียดสถานที่ตั้งร้านค้า และ MatchedLocationInterestView (สําหรับแคมเปญ AI Max) เพื่อแสดงเมตริกประสิทธิภาพตามสถานที่ตั้งทางภูมิศาสตร์ที่สนใจ
Shopping
ShoppingPerformanceView	การรองรับเมตริกใหม่	ตอนนี้รองรับเมตริกต่อไปนี้ที่แบ่งกลุ่มตามวันที่เกิด Conversion: conversions_by_conversion_date, all_conversions_by_conversion_date, conversions_value_by_conversion_date และ value_per_conversions_by_conversion_date, value_per_all_conversions_by_conversion_date
ShoppingPerformanceView	การรองรับเมตริกใหม่	เพิ่มการรองรับสำหรับ search_budget_lost_impression_share, search_rank_lost_impression_share, search_budget_lost_absolute_top_impression_share และ search_rank_lost_absolute_top_impression_share
ShoppingProduct.product_image_uri	ช่องใหม่	เพิ่มไปที่ ShoppingProduct แล้ว
โฆษณาแนวตั้ง
AdGroup.vertical_ads_format_setting	ช่องใหม่	ช่วยให้ควบคุมได้ว่ารูปแบบโฆษณาใดที่แสดงในแคมเปญ Search ได้โดยใช้ฟีดการเดินทาง
AdGroupCriterion SharedCriterion	ช่อง / เกณฑ์ใหม่	เพิ่มประเภทเกณฑ์ vertical_ads_item_group_rule_list ลงใน AdGroupCriterion และ vertical_ads_item_group_rule ลงใน SharedCriterion เพื่ออนุญาตให้กำหนดเป้าหมายกลุ่มรายการในแคมเปญ Search ที่มีฟีดการเดินทาง
การผสานรวมฟีดข้อมูลในบริบทโฆษณาหมวดหมู่	ฟีเจอร์ใหม่	ตอนนี้คุณสามารถเชื่อมต่อฟีดข้อมูลโฆษณาเฉพาะธุรกิจกับแคมเปญ Search ที่ใช้ AI Max เพื่อแสดงโฆษณาการท่องเที่ยวแบบโปรโมชันที่พักและลิงก์การจองควบคู่ไปกับโฆษณาแบบข้อความได้แล้ว ควบคุมรูปแบบด้วย vertical_ads_format_setting และกำหนดกฎโดยใช้ vertical_ads_item_group_rule แบ่งกลุ่มการรายงานตามมิติข้อมูลฟีดข้อมูลโฆษณาแนวตั้งและ AdFormatType
วิดีโอ
AdVideoAssetInfo.ad_video_asset_feature_control	ช่องใหม่	เพิ่มตัวเลือกการควบคุมฟีเจอร์สำหรับชิ้นงานโฆษณาวิดีโอ
CampaignCriterionError	ค่า enum ใหม่ / ข้อผิดพลาด	เพิ่มรหัสข้อผิดพลาด INVALID_VIDEO_LINEUP_ID แล้ว
เมตริกการได้ยินของ YouTube	เมตริกใหม่	เพิ่มเมตริกการได้ยินเสียงสำหรับโฆษณาเสียงบน YouTube ซึ่งจะรายงานว่าโฆษณาได้ยินเสียงหรือไม่ และสามารถวัดการได้ยินเสียงได้กี่ครั้ง

บันทึกประจำรุ่นที่เก็บถาวร

ดูบันทึกประจำรุ่นที่เก็บถาวรได้ที่เวอร์ชันที่เลิกใช้งานแล้ว