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

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

เวอร์ชันหลักและเวอร์ชันย่อยของ 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) ดังนี้
เราได้ย้อนพอร์ตฟีเจอร์นี้ไปยัง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 ไม่มี การนำออก นำฟิลด์และประเภทแผน / การคาดการณ์ต่อไปนี้ออก อัปเดตการผสานรวมตามนั้น
รายงาน
ad_sub_network_type ใน campaign_budget ไม่มี การนำออก นำกลุ่ม ad_sub_network_type ออกจากแหล่งข้อมูล campaign_budget แล้ว
click_type กลุ่มในมุมมองชิ้นงาน ไม่มี การนำออก นำกลุ่มออกจากมุมมอง AdGroupAsset, CampaignAsset และ CustomerAsset แล้ว
วิดีโอ
อนุญาตให้ไม่สำเร็จบางส่วนใน ShareablePreviewService.GenerateShareablePreviews ไม่มีความล้มเหลวบางส่วน การเปลี่ยนแปลงด้านพฤติกรรม คำขอจะล้มเหลวและแสดงข้อผิดพลาดหากรหัสใดก็ตามภายในคำขอไม่ผ่านการตรวจสอบ
ShareablePreviewError โค้ดเดิม 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 ที่แคมเปญไม่ได้เพิ่มประสิทธิภาพ) ลงในแหล่งข้อมูลที่ตรงกันทั้งหมด
conversion_attribution_event_type กลุ่มใหม่ เพิ่มไปที่ ShoppingPerformanceView แล้ว
Shopping
App Campaign ใน ShoppingProduct ฟีเจอร์ใหม่ App Campaign ที่รองรับภายในแหล่งข้อมูล ShoppingProduct ระบบไม่รองรับสถานะและปัญหาของโน้ต
การกรองผลิตภัณฑ์ตามแท็ก ฟีเจอร์ใหม่ เปิดตัวการกรองโดยใช้การแสดงชุดตรรกะแบบไดนามิก ฟีเจอร์นี้ใช้ได้กับบัญชีในรายการที่อนุญาตเท่านั้น

เวอร์ชันหลักและเวอร์ชันย่อยของ 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) ดังนี้

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) ดังนี้

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) ดังนี้

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) ดูเกี่ยวกับรายงาน "ความเหมาะสมของเนื้อหา"

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

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