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

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

เวอร์ชันหลักและเวอร์ชันย่อยของ 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_input (การประกาศที่ผู้ลงโฆษณาให้ไว้โดยตรง) และsystem_input (การรับรองที่ระบบตรวจพบโดยอัตโนมัติหรือที่ระบบให้ไว้) ฟีเจอร์นี้ได้รับการพอร์ตย้อนกลับไปยังเวอร์ชัน 23 และ 22 แล้ว เพื่อช่วยคุณวางแผนงานการผสานรวมที่จะเกิดขึ้นในเวอร์ชัน 25 เราจึงเปิดตัวอินเทอร์เฟซ สำหรับการเปลี่ยนแปลงฟิลด์การรับรองของผู้ลงโฆษณาตั้งแต่เนิ่นๆ สำหรับเวอร์ชัน 22 ขึ้นไป อินเทอร์เฟซจะปรากฏในเวอร์ชันเหล่านี้ แต่ 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 ใหม่	เพิ่ม 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 ตรวจพบโดยอัตโนมัติหรือระบุ) เพื่อช่วยคุณวางแผนงานการผสานรวมที่จะเกิดขึ้นในเวอร์ชัน 25 เราจึงเปิดตัวอินเทอร์เฟซ สำหรับการเปลี่ยนแปลงฟิลด์การรับรองของผู้ลงโฆษณาตั้งแต่เนิ่นๆ สำหรับเวอร์ชัน 22 ขึ้นไป อินเทอร์เฟซจะปรากฏในเวอร์ชันเหล่านี้ แต่ 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 ตัวช่วยสำหรับค่าธรรมเนียมที่ต้องชำระตามกฎหมายและหน่วยวัด
แคมเปญ
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 ตรวจพบโดยอัตโนมัติหรือระบุ) เพื่อช่วยคุณวางแผนงานการผสานรวมที่จะเกิดขึ้นในเวอร์ชัน 25 เราจึงเปิดตัวอินเทอร์เฟซ สำหรับการเปลี่ยนแปลงฟิลด์การรับรองของผู้ลงโฆษณาตั้งแต่เนิ่นๆ สำหรับเวอร์ชัน 22 ขึ้นไป อินเทอร์เฟซจะปรากฏในเวอร์ชันเหล่านี้ แต่ 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
การเสนอราคา TargetCPC	ฟีเจอร์ใหม่	เพิ่มกลยุทธ์การเสนอราคาเพื่อเพิ่มจำนวนคลิกสูงสุดที่ 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 (ระยะเวลาเฉลี่ยต่อการแสดงผล)

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

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

v21.2 (24-06-2026)

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

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

v21.1 (25-02-2026)

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

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

v21 (06-08-2025)

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

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

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

สถานะเริ่มต้น	สถานะใหม่	ประเภทการเปลี่ยนแปลง	คำแนะนำในการติดตั้งใช้งาน
แคมเปญ
การคืนสินค้า CriterionError.INVALID_LISTING_GROUP_HIERARCHY	การคืนสินค้า CriterionError.LISTING_GROUP_ERROR_IN_ANOTHER_OPERATION	การเปลี่ยนแปลงรหัสข้อผิดพลาด	สำหรับคำขอที่เปิดใช้การล้มเหลวบางส่วน ให้จัดการรหัสข้อผิดพลาดใหม่แทนรหัสข้อผิดพลาดของลำดับชั้นเดิม
Conversion
สิทธิ์เข้าถึงโหมด debug_enabled ใน ConversionUploadService	ไม่มี	การนำออก	ระบบจะนำฟิลด์ debug_enabled ออก อัปเดตโค้ดที่อ้างอิงถึงพารามิเตอร์นี้เพื่อไม่ให้ตั้งค่าหรือค้นหาพารามิเตอร์นี้
การโฆษณาด้านการเมืองในสหภาพยุโรป
การประกาศด้วยตนเองของแคมเปญที่ไม่บังคับสำหรับการโฆษณาด้านการเมืองในสหภาพยุโรป	ฟิลด์ที่ต้องระบุ contains_eu_political_advertising สำหรับแคมเปญใหม่	กฎการตรวจสอบ / การเปลี่ยนแปลงพฤติกรรม	การเรียก API เพื่อสร้างแคมเปญใหม่จะไม่สำเร็จและจะแสดงข้อผิดพลาด FieldError.REQUIRED หากไม่ได้ตั้งค่าช่องนี้ ตั้งแต่วันที่ 22 กันยายน 2025 เป็นต้นไป แคมเปญที่ประกาศเป็น CONTAINS_EU_POLITICAL_ADVERTISING จะไม่แสดงในสหภาพยุโรปอีกต่อไป
เกณฑ์ที่แก้ไขได้โดยไม่ต้องประกาศตนเอง	อัปเดตไม่สำเร็จด้วย CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION	กฎการตรวจสอบ / การเปลี่ยนแปลงพฤติกรรม	ตั้งค่าสถานะการประกาศด้วยตนเองก่อนที่จะพยายามสร้างหรืออัปเดตเกณฑ์การกำหนดเป้าหมายตามความใกล้เคียง สถานที่ หรือกลุ่มสถานที่ตั้งระดับแคมเปญหรือกลุ่มโฆษณาสำหรับแคมเปญที่มีอยู่
การทดสอบที่ไม่มีข้อกำหนดในการประกาศตนเอง	อัปเดตไม่สำเร็จด้วย ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION	กฎการตรวจสอบ / การเปลี่ยนแปลงพฤติกรรม	ตรวจสอบว่าได้ทำการประกาศด้วยตนเองในแคมเปญของการทดสอบแล้ว
Performance Max
brand_guidelines_enabled มีค่าเริ่มต้นเป็น false	ค่าเริ่มต้นคือ true	การเปลี่ยนแปลงด้านพฤติกรรม	สำหรับแคมเปญ Performance Max ใหม่ ระบบจะเปิดใช้หลักเกณฑ์การใช้แบรนด์โดยค่าเริ่มต้น ตั้งค่าฟิลด์เป็น false อย่างชัดเจนหากควรปิดใช้
การวางแผน
ประเภทอาร์กิวเมนต์อินพุตเดิมสำหรับ AudienceInsightsService.GenerateTargetingSuggestionMetrics	อินพุตประเภท InsightsAudience	การเปลี่ยนแปลงประเภท	อัปเดตการติดตั้งใช้งานเพื่อส่งประเภทอินพุตใหม่ที่รองรับการรวมความสนใจของผู้ใช้แบบ AND-of-ORs ซึ่งอนุญาตเมตริกการเข้าถึงที่อาจเกิดขึ้นสําหรับคําจํากัดความกลุ่มเป้าหมายที่กําหนดเอง

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

ฟีเจอร์และการอัปเดต	ประเภท	คำอธิบาย
AI Max สำหรับแคมเปญ Search
ai_max_setting.enable_ai_max ใน Campaign	ช่องใหม่	ช่วยให้ AI Max ขยายการจับคู่ข้อความค้นหา (โดยจะใช้การทำงานอัตโนมัติของชิ้นงานข้อความและรายการแบรนด์ก่อนหน้าจนกว่าจะปิด) ฟิลด์ Campaign.ai_max_setting.bundling_required จะระบุว่าต้องเปิดใช้ AI Max เพื่อใช้/แก้ไขการตั้งค่าเหล่านั้นหรือไม่ และ AdGroup.ai_max_ad_group_setting.disable_search_term_matching สามารถปิดใช้การจับคู่ที่ระดับกลุ่มโฆษณาได้ ดูปลดล็อกประสิทธิภาพไปอีกขั้นด้วย AI Max สำหรับแคมเปญ Search
CampaignError.AI_MAX_MUST_BE_ENABLED	ค่า enum / ข้อผิดพลาดใหม่	เกิดขึ้นเมื่อเลือกใช้การทำงานอัตโนมัติของชิ้นงานข้อความในการขยาย URL ในแคมเปญ Search โดยไม่ได้เปิดใช้ AI Max
การกำหนดเป้าหมายระดับกลุ่มโฆษณา	ฟีเจอร์ใหม่	เพิ่มการรองรับใน AI Max สำหรับแคมเปญ Search สำหรับรายการแบรนด์ สถานที่ และหน้าเว็บ (กฎ URL) ที่ระดับกลุ่มโฆษณา
ai_max_search_term_ad_combination_view	แหล่งข้อมูลการรายงานใหม่	รายงานประสิทธิภาพของชุดค่าผสมของข้อความค้นหา บรรทัดแรก และหน้า Landing Page
search_term_match_type กลุ่ม	ค่า enum ใหม่	เพิ่ม AI_MAX เป็นตัวเลือกประเภทการทำงานของคีย์เวิร์ด
ชิ้นงาน
PromotionAsset	ช่องใหม่	เพิ่ม terms_and_conditions_text, terms_and_conditions_uri และตัวเลือก oneof promotion_trigger (promotion_barcode_info, promotion_qr_code_info) ดูเกี่ยวกับชิ้นงานโปรโมชัน
AssetAutomationType.FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION	ค่า enum ใหม่	เพิ่มลงใน AssetAutomationType เพื่อควบคุมข้อความอัตโนมัติและการสร้างหน้า Landing Page จาก URL สุดท้ายในแคมเปญ Search
AutomaticallyCreatedAssetRemovalService.RemoveCampaignAutomaticallyCreatedAsset	บริการ / วิธีการใหม่	อนุญาตให้นำชิ้นงาน Final URL Expansion ที่สร้างขึ้นโดยอัตโนมัติออกจากแคมเปญ
ServedAssetFieldType.DESCRIPTION_PREFIX	ค่า enum ใหม่	เพิ่มเพื่อแก้ไขปัญหาการรายงานที่ระบบแสดงประเภทเป็น UNKNOWN ใน ad_group_ad_asset_combination_view
แคมเปญ
CampaignPrimaryStatusReason.MISSING_LOCATION_TARGETING	ค่า enum ใหม่	แสดงเมื่อแคมเปญที่จำกัดตามสถานที่ไม่มีการกำหนดเป้าหมายตามสถานที่ (ซึ่งตอนนี้จะแสดง LOCATION_TARGETING_NOT_ELIGIBLE_FOR_RESTRICTED_CAMPAIGN หากกำหนดเป้าหมายนอกพื้นที่ที่อนุญาต)
การผสานรวมการวิเคราะห์แอปของบุคคลที่สาม	ช่องใหม่	เพิ่มการรองรับ VideoCustomer.third_party_integration_partners และ Campaign.third_party_integration_partners ดูติดตาม Conversion ของแอปด้วยการวิเคราะห์แอปจากบุคคลที่สาม
Campaign.advertising_partner_ids	การรองรับฟิลด์ใหม่	ตอนนี้ตั้งค่าฟิลด์สําหรับแคมเปญที่มีอยู่ได้แล้ว (จะเปลี่ยนแปลงไม่ได้หลังจากตั้งค่าแล้ว)
ตำแหน่งเชิงลบระดับผู้จัดการ	ฟีเจอร์ใหม่	อนุญาตให้ยกเว้นรายการตำแหน่งในบัญชีผู้ลงโฆษณาแต่ละบัญชีโดยใช้ CustomerNegativeCriterion
การกำหนดค่าความคลาดเคลื่อนในกลยุทธ์ ROAS เป้าหมาย	ช่องใหม่	เพิ่มการรองรับ TargetRoas.target_roas_tolerance_percent_millis (สําหรับกลยุทธ์พอร์ตโฟลิโอของแคมเปญ Search) ใน MaximizeConversionValue และ TargetRoas
LocationInterestView	แหล่งข้อมูลการรายงานใหม่	สรุปประสิทธิภาพของเกณฑ์ความสนใจตามสถานที่ตั้งของกลุ่มโฆษณา
Conversion
conversion_attribution_event_type กลุ่ม	ค่า enum ใหม่	เพิ่ม ENGAGED_VIEW ลงในตัวเลือกประเภทการระบุแหล่งที่มาของ Conversion
Demand Gen
CampaignBudgetError.BUDGET_BELOW_DAILY_MINIMUM	ค่า enum / ข้อผิดพลาดใหม่	เพิ่มเข้ามาเพื่อเตรียมพร้อมสำหรับการบังคับใช้การกำหนดงบประมาณรายวันขั้นต่ำสำหรับแคมเปญ Demand Gen รายละเอียดจะแสดงโดยใช้ budgetDailyMinimumErrorDetails
Performance Max
campaign_search_term_view	แหล่งข้อมูลการรายงานใหม่	รวบรวมเมตริกข้อความค้นหาที่ระดับแคมเปญ ซึ่งช่วยให้วิเคราะห์และรายงานข้อความค้นหาสำหรับ Performance Max ได้
การวางแผน
ReachPlanService.ListPlannableUserInterests	วิธีใหม่	ช่วยในการค้นหากลุ่มความสนใจและกลุ่มที่มีแผนจะซื้อที่วางแผนได้สำหรับ generateReachForecast
AdditionalApplicationInfo	ช่องใหม่	เพิ่มเป็นอินพุตที่ไม่บังคับใน ReachPlanService.ListPlannableUserLists
การแสดงแอตทริบิวต์ข้อมูลเชิงลึกของกลุ่มเป้าหมาย	ฟีเจอร์ใหม่	AudienceInsightsService.ListAudienceInsightsAttributes จะดึงข้อมูลรายการผู้ใช้บุคคลที่หนึ่งที่พร้อมใช้งาน
AudienceCompositionInsights targeting CRM lists	ฟีเจอร์ใหม่	ตอนนี้ AudienceInsightsService.GenerateAudienceCompositionInsights จะแสดงรายละเอียดดัชนีรายชื่อผู้ใช้สําหรับมิติข้อมูล AudienceInsightsDimension ได้แก่ AGE_RANGE, GENDER, AFFINITY_USER_INTEREST และ IN_MARKET_USER_INTEREST
TrendInsightMetrics ส่วนแบ่งผู้ชม	ช่องใหม่	แสดงส่วนแบ่งของผู้ชมสำหรับเทรนด์
KnowledgeGraphAttributeMetadata หมวดหมู่	ช่องใหม่	กรองแอตทริบิวต์กราฟความรู้ตามหมวดหมู่ที่ตรงกัน
รายงาน
เมตริกการดูชิ้นงาน	ฟีเจอร์ / เมตริกใหม่	เพิ่มเมตริกใหม่หลายรายการไปยัง AssetGroupAsset, ChannelAggregateAssetView และ CampaignAggregateAssetView ตอนนี้แคมเปญ PMax ยังรายงานมูลค่าที่แท้จริงสําหรับ impressions ด้วย
ส่วนขยายตัวเลือก	ฟีเจอร์ใหม่	ทำให้ AssetSet และ CampaignAssetSet ค้นหาได้ด้วยกันภายใน ChangeStatus
search_term_targeting_status	กลุ่มใหม่	กลุ่มที่เลือกได้ในมุมมองคำค้นหาของแคมเปญ
final_url_expansion_asset_view	แหล่งข้อมูลการรายงานใหม่	รายงานรายละเอียดประสิทธิภาพของชิ้นงานที่ใช้ Final URL Expansion
การปรับมูลค่า AssetGroup	ช่องใหม่	เพิ่มการรองรับเมตริก value_adjustment และ all_value_adjustment ในรายงาน AssetGroup
landing_page_source	กลุ่มใหม่	ระบุกลุ่มแหล่งที่มาของหน้า Landing Page ใน landing_page_view
search_term_match_source	กลุ่มใหม่	กลุ่มที่เลือกได้ในมุมมองข้อความค้นหาและมุมมองข้อความค้นหาของแคมเปญ
match_type	กลุ่มใหม่	คีย์กลุ่มที่เลือกได้ในมุมมองคีย์เวิร์ด
การรายงานคลัสเตอร์เจตนาของคำค้นหาที่ไม่ซ้ำ	ช่องใหม่	เพิ่ม clicks_unique_query_clusters, conversions_unique_query_clusters และ impressions_unique_query_clusters เพื่อรายงานคลัสเตอร์ความตั้งใจในการค้นหาที่ไม่ซ้ำกัน
ClickType.VEHICLE_ASSETS	ค่า enum ใหม่	ติดตามและรายงานการคลิกที่เกี่ยวข้องกับรูปแบบโฆษณายานพาหนะโดยเฉพาะในclick_viewรายงาน
การสำรวจ Smart Bidding
การกำหนดค่าความคลาดเคลื่อนในกลยุทธ์ Search	ฟิลด์ / การตั้งค่าใหม่	อนุญาตให้เปิดใช้การสำรวจ Smart Bidding ในแคมเปญ Search โดยการตั้งค่า target_roas_tolerance_percent_millis ระหว่าง 10,000 (10%) ถึง 30,000 (30%) รวม (การเพิ่มจำนวน Conversion สูงสุดต้องมีการตั้งค่า target_roas) ดูบล็อกโพสต์เกี่ยวกับการสำรวจ Smart Bidding และบทความในศูนย์ช่วยเหลือ
ความเข้ากันได้ของการรายงานความหลากหลาย	ฟีเจอร์ใหม่	ตอนนี้ระบบรองรับการรายงานความหลากหลายแบบรวมสําหรับเมตริกต่อไปนี้สําหรับคลัสเตอร์เจตนาในการค้นหาที่ไม่ซ้ำกันแล้ว มุมมองที่แบ่งตามเวลาพร้อมใช้งานใน UI ของ Google Ads ดังนี้ clicks_unique_query_clusters conversions_unique_query_clusters impressions_unique_query_clusters
วิดีโอ
YouTubeVideoListAsset	ทรัพยากร / ฟิลด์ใหม่	ช่วยสร้างลิงก์ระหว่างแคมเปญกับชิ้นงานรายการวิดีโอโดยใช้ Asset.youtube_video_list_asset ดูหัวข้อใช้วิดีโอที่เกี่ยวข้อง
ส่วนขยายข้อมูลเมตาของข้อมูลเชิงลึก	ช่องใหม่	เพิ่มข้อมูลเมตาใหม่ใน YouTubeChannelInsights และ YouTubeVideoAttributeMetadata
ประเภทการคลิกแบบอินเทอร์แอกทีฟ	ค่า enum ใหม่	เพิ่มประเภทการคลิก: VIDEO_RELATED_VIDEOS_CLICK, VIDEO_CHANNEL_CLICK และ PRODUCT_ASSETS
VideoAdInventoryControl.allow_non_skippable_in_stream	ช่องใหม่	อนุญาตให้โฆษณาวิดีโอที่ปรับเปลี่ยนตามพื้นที่โฆษณาแสดงเป็นโฆษณาในสตรีมแบบข้ามไม่ได้สําหรับแคมเปญที่ผสมรูปแบบแบบข้ามได้และแบบข้ามไม่ได้
การตั้งค่าการจัดลำดับวิดีโอ	ช่องใหม่	เพิ่มการกำหนดค่าการจัดลำดับแบบอ่านอย่างเดียว: Campaign.VideoCampaignSettings.video_ad_sequence และ VideoAdSequenceStepSetting ดูเกี่ยวกับโฆษณาวิดีโอต่อเนื่อง
การกำหนดเป้าหมายรายการช่องวิดีโอ	ประเภท / ฟิลด์เกณฑ์ใหม่	เพิ่มประเภทเกณฑ์ VIDEO_LINEUP และฟิลด์ที่เกี่ยวข้องใน CampaignCriterion และ AdGroupCriterion ฟีเจอร์นี้พร้อมให้บริการสำหรับบัญชีในรายการที่อนุญาตเท่านั้น
การดูตําแหน่งโฆษณาตามความเหมาะสมของเนื้อหา	แหล่งข้อมูลการรายงานใหม่	เพิ่มรายงานความเหมาะสมของเนื้อหาทั้งในระดับรายละเอียด (detail_content_suitability_placement_view) และระดับกลุ่ม (group_content_suitability_placement_view) ดูเกี่ยวกับรายงาน "ความเหมาะสมของเนื้อหา"

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

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