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

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

เวอร์ชันหลักและเวอร์ชันย่อยของ 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, 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 ของโฆษณา "/เครื่องแต่งกาย/เสื้อผ้า") ไม่ได้รับการรองรับสําหรับไตรมาสที่เปิดอยู่ และจะถูกละเว้นจากคําตอบ เว้นแต่ 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 ด้วยการอัปเดตต่อไปนี้ เพิ่มแหล่งข้อมูลมิติข้อมูลแบบอ่านอย่างเดียวใหม่สำหรับผลลัพธ์การศึกษา Lift ได้แก่ LiftMeasurementAgeRange, LiftMeasurementCampaign, LiftMeasurementDevice, LiftMeasurementGender และ LiftMeasurementVideo เพิ่มกลุ่มและเมตริกใหม่เพื่อรองรับการวิเคราะห์ Brand Lift ด้วย LiftMeasurementConfig และแหล่งข้อมูลมิติข้อมูลใหม่ เพิ่ม Enum ต่อไปนี้ BrandLiftMeasurementType, LiftMeasurementFlightStatus, SurveyIntendedAction, SurveyLiftFlightTargetResponseMode และ SurveySubjectType
การวัดผลด้วย Conversion Lift	ฟีเจอร์ใหม่	เพิ่มการรองรับการวัด Conversion Lift ด้วยการอัปเดตต่อไปนี้ เพิ่มทรัพยากรแบบอ่านอย่างเดียวใหม่ LiftMeasurementConfig ซึ่งแสดงถึงการศึกษา Lift เพิ่มกลุ่มใหม่ที่เลือกได้เพื่อจัดกลุ่มและกรองผลลัพธ์ Lift เพิ่มเมตริก Conversion Lift ใหม่ 24 รายการและเมตริกคะแนนผู้ชนะที่รองรับการวิเคราะห์ทางสถิติโดยละเอียดของประสิทธิภาพการเพิ่ม เพิ่มการรองรับการดึงรายละเอียดแคมเปญและเป้าหมาย Conversion เพิ่มฟิลด์ที่ไม่บังคับรายการใหม่ Experiment.lift_measurement_config เพิ่มการแจงนับ ConversionLiftIncludedConversionActionTypes
LiftMeasurementFlight	แหล่งข้อมูลใหม่	แหล่งข้อมูลแบบอ่านอย่างเดียวใหม่ที่แสดงรายละเอียดการแสดงโฆษณาสําหรับการกําหนดค่าการวัดผลด้วย 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 เพิ่มการแจงนับ Sentiment เพิ่มค่า BRAND_SENTIMENT_DATA ลงใน Enum ContentCreatorInsightsSupplementalData เพิ่มค่า BRAND ลงใน Enum InsightsKnowledgeGraphEntityCapabilities
BenchmarksService การปรับปรุง	ฟีเจอร์ใหม่	เพิ่มการรองรับหมวดหมู่เป็นตัวกรองสำหรับการกำหนดขอบเขตการวิเคราะห์การเปรียบเทียบ นอกจากนี้ยังรองรับเมตริกที่สำคัญต่อธุรกิจเพิ่มเติมต่อไปนี้ เพิ่มตัวเลือกในการเปรียบเทียบกับผู้ลงโฆษณาทั้งหมดที่แสดงโฆษณาในหมวดหมู่ผลิตภัณฑ์และบริการอย่างน้อย 1 หมวดหมู่โดยใช้ BenchmarksService.GenerateBenchmarksMetrics และ category_filter แสดงเมตริกโฆษณาของลูกค้ามากขึ้น เช่น ต้นทุนรวมและการดูของลูกค้า และแชร์เมตริก เช่น share_of_voice ระบบจะแสดงเมตริกโดยใช้ AggregateMetrics และ ShareMetrics คุณสามารถดึงรายการหมวดหมู่ที่รองรับได้โดยใช้ BenchmarksService.ListBenchmarksSources ที่มีแหล่งข้อมูลประเภท CATEGORY
การกำหนดเป้าหมายตามสถานะความเป็นบิดามารดา	ฟีเจอร์ใหม่	เพิ่มการรองรับการกำหนดเป้าหมายตามสถานะความเป็นบิดามารดาในการวางแผนการเข้าถึง เพิ่มฟิลด์ใหม่ 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 oneofs ตามลำดับ พร้อมกับฟิลด์ value_multiplier และ high_lifetime_value_multiplier ใหม่	การเปลี่ยนแปลงโครงสร้าง	อัปเดตการอ้างอิงฟิลด์เหล่านี้เนื่องจากตอนนี้เป็นส่วนหนึ่งของ Oneof แล้ว
ทรัพยากร CustomerLifecycleGoal และ CampaignLifecycleGoal เวอร์ชันเดิม บริการที่เกี่ยวข้อง CustomerLifecycleGoalService และ CampaignLifecycleGoalService รวมถึงการตั้งค่า/การแจงนับเวอร์ชันเดิม (CustomerAcquisitionGoalSettings, CustomerAcquisitionOptimizationModeEnum, LifecycleGoalValueSettings)	ไม่มี	การนำออก	ใช้สคีมาเป้าหมายแบบรวมที่ปรับปรุงใหม่ดังนี้ ใช้ฟิลด์ new_customer_acquisition_goal_settings ในทรัพยากร Goal ใช้ฟิลด์ campaign_new_customer_acquisition_settings ในแหล่งข้อมูล CampaignGoalConfig เพื่อกําหนดค่าการลบล้างเฉพาะแคมเปญ
ทั่วไป
ฟิลด์ enum ที่ซ้อนกันในข้อความคำขอบริการและการตอบกลับของ Incentive Service 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 เพิ่มการแจงนับ CustomerLifecycleOptimizationGoalSubType ใหม่เพื่อกำหนดประเภทย่อยของเป้าหมายที่รองรับ เพิ่ม NEW_CUSTOMER_ACQUISITION ลงในแจงนับ 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 (การรับรองที่ระบบตรวจพบโดยอัตโนมัติหรือที่ระบบให้ไว้) เราได้ย้อนกลับฟีเจอร์นี้ไปยังเวอร์ชัน 23 และ 22 แล้ว เราขอแนะนำอินเทอร์เฟซสำหรับการเปลี่ยนแปลงฟิลด์การรับรองของผู้ลงโฆษณาตั้งแต่เนิ่นๆ สำหรับ v22 ขึ้นไป เพื่อช่วยคุณวางแผนงานการผสานรวม v25 ที่กำลังจะมาถึง อินเทอร์เฟซจะปรากฏในเวอร์ชันเหล่านี้ แต่ synthetic_content_info.advertiser_attestation.status และ synthetic_content_info.advertiser_attestation.source จะ ยังคงไม่เปลี่ยนแปลงสำหรับเวอร์ชันเหล่านี้ หากคุณพยายามส่งคำขอเปลี่ยนแปลงข้อมูลในเซิร์ฟเวอร์ในช่องใดช่องหนึ่ง ระบบจะแสดงข้อผิดพลาดต่อไปนี้ "ฟิลด์ที่พยายามเปลี่ยนแปลงเป็นแบบเปลี่ยนแปลงไม่ได้" หรือ "ตั้งค่าฟิลด์ไม่ได้" ช่องเหล่านี้จะแก้ไขได้อย่างเต็มที่ตั้งแต่เวอร์ชัน 25 เป็นต้นไป เราขอแนะนำให้ ใช้อินเทอร์เฟซตอนนี้เพื่อสร้างและทดสอบตรรกะภายในเพื่อให้ ระบบของคุณพร้อมสำหรับความสามารถในการเขียนแบบเต็มเมื่อเปิดตัว v25
การอนุมัติโดยหลายฝ่าย	ฟีเจอร์ใหม่	เบต้า: ขณะนี้ฟีเจอร์นี้ยังอยู่ในเวอร์ชันเบต้าและอาจมีการ เปลี่ยนแปลงในรุ่นต่อๆ ไป เพิ่มการรองรับการตรวจสอบการอนุมัติโดยหลายฝ่าย (MPA) เพิ่มแหล่งข้อมูล MultiPartyAuthReview และ MultiPartyAuthReviewService ที่เกี่ยวข้อง เพิ่มการแจงนับ 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 มีการแจงนับ 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
CampaignCriterion.gender	ฟีเจอร์ใหม่	เปิดใช้การยกเว้นเพศสำหรับแคมเปญ Performance Max ใน Google Ads API ทุกเวอร์ชัน
Conversion
ประเภท Conversion ของ Lead Gen	ค่า 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 จะ ยังคงไม่เปลี่ยนแปลงสำหรับเวอร์ชันเหล่านี้ หากคุณพยายามส่งคำขอเปลี่ยนแปลงข้อมูลในเซิร์ฟเวอร์ในช่องใดช่องหนึ่ง ระบบจะแสดงข้อผิดพลาดต่อไปนี้ "ฟิลด์ที่พยายามเปลี่ยนแปลงเป็นแบบเปลี่ยนแปลงไม่ได้" หรือ "ตั้งค่าฟิลด์ไม่ได้" ช่องเหล่านี้จะแก้ไขได้อย่างเต็มที่ตั้งแต่เวอร์ชัน 25 เป็นต้นไป เราขอแนะนำให้ ใช้อินเทอร์เฟซตอนนี้เพื่อสร้างและทดสอบตรรกะภายในเพื่อให้ ระบบของคุณพร้อมสำหรับความสามารถในการเขียนแบบเต็มเมื่อเปิดตัว v25
การอนุมัติจากผู้ที่มีสิทธิ์	ฟีเจอร์ใหม่	เบต้า: ขณะนี้ฟีเจอร์นี้ยังอยู่ในเวอร์ชันเบต้าและอาจมีการ เปลี่ยนแปลงในรุ่นต่อๆ ไป เพิ่มการรองรับการตรวจสอบการอนุมัติจากผู้ที่มีสิทธิ์ (MPA) เพิ่มแหล่งข้อมูล MultiPartyAuthReview และ MultiPartyAuthReviewService ที่เกี่ยวข้อง เพิ่มการแจงนับ 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 ซึ่งจะรายงานว่าโฆษณาได้ยินหรือไม่ และวัดการได้ยินในการแสดงผลได้กี่ครั้ง

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

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

v22.2 (24-06-2026)

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

ฟีเจอร์และการอัปเดต	ประเภท	คำอธิบาย
ทั่วไป
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 จะ ยังคงไม่เปลี่ยนแปลงสำหรับเวอร์ชันเหล่านี้ หากคุณพยายามส่งคำขอเปลี่ยนแปลงข้อมูลในเซิร์ฟเวอร์ในช่องใดช่องหนึ่ง ระบบจะแสดงข้อผิดพลาดต่อไปนี้ "ฟิลด์ที่พยายามเปลี่ยนแปลงเป็นแบบเปลี่ยนแปลงไม่ได้" หรือ "ตั้งค่าฟิลด์ไม่ได้" ช่องเหล่านี้จะแก้ไขได้อย่างเต็มที่ตั้งแต่เวอร์ชัน 25 เป็นต้นไป เราขอแนะนำให้ ใช้อินเทอร์เฟซตอนนี้เพื่อสร้างและทดสอบตรรกะภายในเพื่อให้ ระบบของคุณพร้อมสำหรับความสามารถในการเขียนแบบเต็มเมื่อเปิดตัว v25
การอนุมัติจากผู้ที่มีสิทธิ์	ฟีเจอร์ใหม่	เบต้า: ขณะนี้ฟีเจอร์นี้ยังอยู่ในเวอร์ชันเบต้าและอาจมีการ เปลี่ยนแปลงในรุ่นต่อๆ ไป เพิ่มการรองรับการตรวจสอบการอนุมัติจากผู้ที่มีสิทธิ์ (MPA) เพิ่มแหล่งข้อมูล MultiPartyAuthReview และ MultiPartyAuthReviewService ที่เกี่ยวข้อง เพิ่มการแจงนับ MultiPartyAuthReviewStatus เพื่อติดตามสถานะการตรวจสอบ เพิ่ม CustomerUserAccess.pending_multi_party_auth_review เพื่อลิงก์ไปยังรีวิวที่รอดำเนินการ เพิ่ม MutateCustomerUserAccessResult.multi_party_auth_review และ MutateCustomerUserAccessInvitationResult.multi_party_auth_review เพื่อแสดงชื่อทรัพยากรของรีวิวที่เชื่อมโยง เพิ่ม MultiPartyAuthReviewError สำหรับข้อผิดพลาดในการตรวจสอบ

v22.1 (25-02-2026)

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

ฟีเจอร์และการอัปเดต	ประเภท	คำอธิบาย
การจัดการบัญชี
Customer.contains_eu_political_advertising	ช่องใหม่	ดึงข้อมูลสถานะการประกาศระดับบัญชีว่ามีการโฆษณาทางการเมืองที่กำหนดเป้าหมายไปยังสหภาพยุโรปหรือไม่ และแสดงผล EuPoliticalAdvertisingStatus
แคมเปญ
Campaign.missing_eu_political_advertising_declaration	ช่องใหม่	รองรับการค้นหาและการกรองแคมเปญที่ไม่มีประกาศว่ามีโฆษณาทางการเมืองที่กำหนดเป้าหมายไปยังสหภาพยุโรปหรือไม่

v22 (15-10-2025)

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

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

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

สถานะเริ่มต้น	สถานะใหม่	ประเภทการเปลี่ยนแปลง	หลักเกณฑ์การใช้งาน
Demand Gen
BudgetPerDayMinimumErrorDetails.minimum_bugdet_amount_micros	minimum_budget_amount_micros	เปลี่ยนชื่อ / แก้ไขการสะกด	เปลี่ยนชื่อการอ้างอิงเพื่อใช้ชื่อฟิลด์ที่แก้ไขแล้ว
ทั่วไป
ไม่มีขีดจำกัดการดำเนินการใน AddBatchJobOperations	ขีดจำกัดการดำเนินการ 10,000 รายการต่อคำขอ	การเปลี่ยนแปลงเชิงพฤติกรรม	ตรวจสอบว่าAddBatchJobOperationsคำขอเดียวมีจำนวนการดำเนินการไม่เกิน 10,000 รายการ
จำกัดขนาดหน้าไว้ที่ 1,000 ใน ListBatchJobResultsRequest โดยไม่มีการแจ้งเตือน	ข้อผิดพลาดในการคืนสินค้า INVALID_PAGE_SIZE	การเปลี่ยนแปลงเชิงพฤติกรรม	ตรวจสอบว่าได้ตั้งค่า ListBatchJobResultsRequest.page_size เป็น 1,000 หรือน้อยกว่า เนื่องจากตอนนี้การขอขนาดหน้าเว็บที่ใหญ่ขึ้นจะทำให้เกิดข้อผิดพลาด
Performance Max
ป้ายกำกับประสิทธิภาพของชิ้นงาน	ไม่มี	การนำออก	ระบบได้นำการรองรับป้ายกำกับประสิทธิภาพของชิ้นงานและ Enum ป้ายกำกับประสิทธิภาพที่เกี่ยวข้องออกสำหรับแคมเปญ Performance Max อัปเดตการผสานรวมตามนั้น
Campaign.url_expansion_opt_out	FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION แจ้งว่าไม่เหมาะสมใน AssetAutomationSetting	การนำออก / การเปลี่ยนทดแทน	ใช้การตั้งค่าการทำงานอัตโนมัติของชิ้นงานข้อความ Final URL Expansion นำช่องการเลือกไม่ใช้การขยาย URL ระดับแคมเปญออกแล้ว
การวางแผน
views	trueview_views	การนำออก / การเปลี่ยนทดแทน	แทนที่การอ้างอิงถึง views ด้วยฟิลด์ trueview_views ใหม่ใน ReachPlanService
วิดีโอ
average_cpv video_view_rate video_views video_view_rate_in_feed video_view_rate_in_stream video_view_rate_shorts	trueview_average_cpv video_trueview_view_rate video_trueview_views video_trueview_view_rate_in_feed video_trueview_view_rate_in_stream video_trueview_view_rate_shorts	เปลี่ยนชื่อ	อัปเดตสตริงการค้นหาและการผสานรวมเพื่อใช้ชื่อเมตริกใหม่ที่แสดงยอดดูวิดีโอ TrueView

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

ฟีเจอร์และการอัปเดต	ประเภท	คำอธิบาย
ชิ้นงาน
AssetFieldType.LANDING_PAGE_PREVIEW	ค่า enum ใหม่	เพิ่มเป็นประเภทฟิลด์ชิ้นงานรูปภาพใหม่
AssetGenerationService	บริการใหม่ (เบต้า)	อนุญาตให้สร้างชิ้นงานข้อความและรูปภาพโดยใช้ Generative AI GenerateText: สร้างข้อความตาม URL สุดท้าย พรอมต์ คีย์เวิร์ด ฯลฯ GenerateImages: สร้างรูปภาพตาม URL สุดท้าย พรอมต์ หรือการปรับบริบทของรูปภาพผลิตภัณฑ์ ระบบจะแสดงข้อผิดพลาดพร้อมรหัสจาก AssetGenerationError ในช่วงแรกจะพร้อมให้บริการแก่ผู้เข้าร่วมรุ่นเบต้าแบบจำกัดผู้ใช้งานเพียงไม่กี่รายเท่านั้น
แคมเปญ
AppCampaignBiddingStrategyGoalType	ค่า enum ใหม่	เพิ่มเป้าหมายใหม่สำหรับ App Campaign เพื่อการติดตั้ง (ACi) เพื่อเพิ่มประสิทธิภาพโดยไม่ต้องระบุเป้าหมาย OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA: ใช้กับกลยุทธ์การเพิ่มจำนวน Conversion สูงสุดแบบมาตรฐาน OPTIMIZE_TOTAL_VALUE_WITHOUT_TARGET_ROAS: ใช้กับการเพิ่มมูลค่า Conversion สูงสุดแบบมาตรฐาน
BiddingStrategyType	ฟีเจอร์ใหม่	เพิ่มการรองรับประเภทกลยุทธ์การเสนอราคาแบบส่วนแบ่งเสียงคงที่
Campaign.feed_types	ช่องใหม่	แสดงประเภทฟีดที่แนบกับแคมเปญ สําหรับแคมเปญ Performance Max พารามิเตอร์นี้อาจระบุกลุ่มธุรกิจ เช่น MERCHANT_CENTER_FEED สําหรับธุรกิจค้าปลีก
การกำหนดเป้าหมายชุดที่ใช้ร่วมกัน	ฟีเจอร์ใหม่	อนุญาตให้แนบชุดคีย์เวิร์ดเชิงลบที่ใช้ร่วมกันกับแคมเปญแบบหลายช่องทาง (สําหรับ App Campaign) และแคมเปญในพื้นที่
Demand Gen
การเสนอราคา tCPC	ฟีเจอร์ใหม่	เพิ่มกลยุทธ์การเสนอราคาเพื่อเพิ่มจำนวนคลิกสูงสุดที่ CPC เป้าหมาย: ตั้งค่า CPC เป้าหมายระดับแคมเปญโดยใช้ Campaign.target_cpc และลบล้างที่ระดับกลุ่มโฆษณาโดยใช้ AdGroup.target_cpc_micros
AssetAutomationType.GENERATE_DESIGN_VERSIONS_FOR_IMAGES	ค่า enum ใหม่	หากเปิดใช้สำหรับ DemandGenMultiAssetAdInfo ระบบจะเพิ่มองค์ประกอบการออกแบบและฝังชิ้นงานข้อความลงในชิ้นงานรูปภาพเพื่อสร้างชิ้นงานรูปภาพใหม่ที่มีสัดส่วนภาพต่างกัน (เปิดใช้โดยค่าเริ่มต้น)
AssetAutomationType.GENERATE_VIDEOS_FROM_OTHER_ASSETS	ค่า enum ใหม่	หากเปิดใช้สำหรับ DemandGenMultiAssetAdInfo ระบบจะสร้างวิดีโอโดยใช้ชิ้นงานอื่นๆ เช่น รูปภาพและข้อความ ซึ่งสามารถนำไปใช้สร้างอินสแตนซ์ DemandGenVideoResponsiveAdInfo ใหม่ได้ (เปิดใช้โดยค่าเริ่มต้น)
ทั่วไป
ListBatchJobResultsRequest ขนาดหน้าเว็บสำรอง	การเปลี่ยนแปลงพฤติกรรม	หากไม่ได้ตั้งค่า page_size หรือตั้งค่าเป็น 0 ตอนนี้ระบบจะตั้งค่าเริ่มต้นเป็นสูงสุด 1,000 (ก่อนหน้านี้จะแสดง INVALID_PAGE_SIZE)
QuotaError	ค่า enum ใหม่ / ข้อผิดพลาด	เพิ่ม PAYMENTS_PROFILE_ACTIVATION_RATE_LIMIT_EXCEEDED เพื่อระบุเมื่อมีการใช้งานเกินขีดจำกัดอัตราการเปิดใช้งานโปรไฟล์การชำระเงิน
Performance Max
การตั้งค่าการทำงานอัตโนมัติของชิ้นงาน	ค่า enum ใหม่	เพิ่มตัวเลือกการทำงานอัตโนมัติของชิ้นงาน PMax ใหม่ ดังนี้ GENERATE_IMAGE_ENHANCEMENT: เปิดใช้การสร้างรูปภาพที่ดียิ่งขึ้นโดยอัตโนมัติ (ครอบตัดอัตโนมัติ) เปิดใช้โดยค่าเริ่มต้น GENERATE_IMAGE_EXTRACTION: รูปภาพที่มาจาก URL สุดท้าย ค่าเริ่มต้นคือการตั้งค่าส่วนขยายรูปภาพแบบไดนามิกของบัญชี
กลุ่มการรายงาน PMax	กลุ่มใหม่	เพิ่มกลุ่มใหม่เฉพาะสำหรับแคมเปญ Performance Max ดังนี้ ad_using_product_data: ระบุว่าโฆษณานั้นใช้ข้อมูลสินค้า Google Merchant Center หรือไม่ ad_using_video: ระบุว่าโฆษณาใช้ชิ้นงานวิดีโอหรือไม่
การวางแผน
รายการข้อมูลพาร์ทเนอร์ CRM	ฟีเจอร์ใหม่ / ค่า enum	เพิ่ม THIRD_PARTY_PARTNER_DATA ลงในแหล่งข้อมูล CRM พร้อมกับรหัสข้อผิดพลาดในการตรวจสอบกลุ่มเป้าหมายของพาร์ทเนอร์ (เช่น การยอมรับข้อกำหนดในการให้บริการ ลิงก์ขาดหายไป ฯลฯ)
เมตริกของครีเอเตอร์ไลฟ์สด	ช่องใหม่	เพิ่ม YouTubeMetrics.is_active_live_stream_creator ซึ่งข้อมูลเชิงลึกของครีเอเตอร์จะแสดงเพื่อระบุว่าครีเอเตอร์เผยแพร่ไลฟ์สดในช่วง 90 วันที่ผ่านมาหรือไม่
ข้อมูลเมตาแหล่งที่มาของ CRM ที่วางแผนได้	ข้อความใหม่	เพิ่ม PlannableUserListMetadata ภายใน PlannableUserList ที่ ReachPlanService.ListPlannableUserLists ส่งคืน เพื่อแสดงประเภทแหล่งข้อมูล CRM
การรองรับวิดีโอและครีเอเตอร์ที่เกี่ยวข้องในข้อมูลเชิงลึกเกี่ยวกับเทรนด์	ช่องใหม่	เพิ่มการรองรับ related_videos และ related_creators ใน TrendInsight รวมถึงพร็อพเพอร์ตี้ของนาฬิกาใน video_properties และ publish_date
การปรับปรุง InsightsFinder	ฟีเจอร์ใหม่	ตอนนี้ GenerateInsightsFinderReport รองรับ parental_status, income_ranges และการกำหนดเป้าหมายแบบ AND/OR ที่ซับซ้อนมากขึ้น
รายงาน
ประเภทการคลิกใหม่	ค่า enum ใหม่	เพิ่ม CLICK_TO_MESSAGE_THIRD_PARTY_CLICK และ CLICK_TO_MESSAGE_LANDING_PAGE_CLICK แล้ว
การแบ่งกลุ่ม AssetGroupAsset	การรองรับกลุ่มใหม่	ตอนนี้คุณสามารถแบ่งกลุ่ม AssetGroupAsset ตาม device, conversion_action, conversion_action_name และ conversion_action_category ได้แล้ว
RSA ใน AdGroupAdAssetView	การรองรับฟีเจอร์ / เมตริกใหม่	ตอนนี้ AdGroupAdAssetView รองรับเมตริกประสิทธิภาพและ Conversion สำหรับ RESPONSIVE_SEARCH_AD อย่างเต็มรูปแบบ (ก่อนหน้านี้จะแสดงเฉพาะการแสดงผล)
การแบ่งกลุ่มเมตริกคลัสเตอร์คําค้นหาการสํารวจ	การรองรับกลุ่มใหม่	ตอนนี้คุณสามารถแบ่งกลุ่มเมตริก clicks_unique_query_clusters, conversions_unique_query_clusters และ impressions_unique_query_clusters ตามช่องวันที่ได้แล้ว
TargetingExpansionView	แหล่งข้อมูลการรายงานใหม่	เพิ่ม TargetingExpansionView เพื่อรายงานเมตริกสําหรับการขยายการกําหนดเป้าหมายด้วยตนเอง เช่น การขยายแบบไร้คีย์เวิร์ดสําหรับ AI Max สําหรับแคมเปญ Search
Shopping
การแก้ไขขอบเขต Shopping	แก้ไขข้อบกพร่อง	แก้ไขการกำหนดขอบเขตแคมเปญและกลุ่มโฆษณาของเมตริกในแหล่งข้อมูล ShoppingProduct
เป้าหมายแบบรวม
เป้าหมายการรักษาลูกค้า	ฟีเจอร์ใหม่	เพิ่มการรองรับเป้าหมายการรักษาลูกค้าเพื่อเพิ่มประสิทธิภาพในการดึงดูดลูกค้าเดิมให้กลับมามีส่วนร่วม (เช่น การใช้ target_option กับ TARGET_SPECIFIC หรือ TARGET_ALL)
วิดีโอ
เมตริกเวลาในการรับชมวิดีโอ	ช่องใหม่	เพิ่มเมตริกระยะเวลาเวลาในการรับชม: video_watch_time_duration_millis (ระยะเวลารวม) และ average_video_watch_time_duration_millis (ระยะเวลาเฉลี่ยต่อการแสดงผล)

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

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