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

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

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

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

v25.1 (19-08-2026)

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

ฟีเจอร์และการอัปเดต ประเภท คำอธิบาย
ชิ้นงาน
AssetFieldType.TEXT_DISCLAIMER
ServedAssetFieldType.TEXT_DISCLAIMER
ค่า enum ใหม่ เพิ่มการรองรับชิ้นงานข้อจำกัดความรับผิดแบบข้อความ
แคมเปญ
Campaign.aca_migration_date_time
Campaign.broad_match_migration_date_time
ช่องใหม่ ติดตามการย้ายข้อมูลอัตโนมัติที่กำลังจะเกิดขึ้นไปยัง AI Max
Conversion
การวัด Brand Lift ฟีเจอร์ใหม่ เพิ่มการรองรับการวัด Brand Lift ด้วยการอัปเดตต่อไปนี้
การวัด Conversion Lift ฟีเจอร์ใหม่ เพิ่มการรองรับการวัด Conversion Lift ด้วยการอัปเดตต่อไปนี้
  • เพิ่มทรัพยากรแบบอ่านอย่างเดียวใหม่ LiftMeasurementConfig ซึ่งแสดงถึงการศึกษา Lift
  • เพิ่มกลุ่มใหม่ที่เลือกได้เพื่อจัดกลุ่มและกรองผลลัพธ์ Lift
  • เพิ่มเมตริก Conversion Lift ใหม่ 24 รายการและเมตริกคะแนนผู้ชนะที่รองรับการวิเคราะห์ทางสถิติโดยละเอียดของประสิทธิภาพ Lift
  • เพิ่มการรองรับการดึงรายละเอียดแคมเปญและเป้าหมาย Conversion
  • เพิ่มฟิลด์ที่ไม่บังคับรายการใหม่ Experiment.lift_measurement_config
  • เพิ่มการแจงนับ ConversionLiftIncludedConversionActionTypes
LiftMeasurementFlight แหล่งข้อมูลใหม่ แหล่งข้อมูลแบบอ่านอย่างเดียวใหม่ที่แสดงรายละเอียดเที่ยวบินสำหรับการกำหนดค่าการวัดผลด้วย Lift รวมถึงวันที่เริ่มต้นและวันที่สิ้นสุดของเที่ยวบินที่วัดผล (start_date และ end_date)
ทั่วไป
SmartCampaignError ค่า enum ใหม่ เพิ่มรหัสข้อผิดพลาดใหม่ที่เฉพาะเจาะจงสำหรับข้อจำกัดในการสร้าง Performance Max ดังนี้
AuthorizationErrorEnum.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION ค่า enum / ข้อผิดพลาดใหม่ แสดงเมื่อโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google Cloud ที่มีระดับการเข้าถึง TEST พยายามส่งคำขอไปยังบัญชีที่ไม่ใช่บัญชีทดสอบ
การวางแผน
ข้อมูลเชิงลึกเกี่ยวกับความรู้สึกที่มีต่อแบรนด์ ฟีเจอร์ใหม่ เพิ่มการรองรับข้อมูลเชิงลึกเกี่ยวกับความรู้สึกต่อแบรนด์ใน ContentCreatorInsightsService ดังนี้
การปรับปรุง BenchmarksService ฟีเจอร์ใหม่ เพิ่มการรองรับหมวดหมู่เป็นตัวกรองสำหรับการกำหนดขอบเขตการวิเคราะห์การเปรียบเทียบ นอกจากนี้ยังรองรับเมตริกที่สำคัญต่อธุรกิจเพิ่มเติมดังนี้
  • เพิ่มตัวเลือกในการเปรียบเทียบกับผู้ลงโฆษณาทั้งหมดที่ลงโฆษณาในหมวดหมู่ผลิตภัณฑ์และบริการอย่างน้อย 1 หมวดหมู่โดยใช้ BenchmarksService.GenerateBenchmarksMetrics และ category_filter
  • แสดงเมตริกโฆษณาของลูกค้ามากขึ้น เช่น ต้นทุนรวม ยอดดู ฯลฯ ของลูกค้า และแชร์เมตริก เช่น share_of_voice ระบบจะแสดงเมตริกโดยใช้ AggregateMetrics และ ShareMetrics
  • คุณเรียกรายการหมวดหมู่ที่รองรับได้โดยใช้ BenchmarksService.ListBenchmarksSources ที่มีแหล่งข้อมูลประเภท CATEGORY
การกำหนดเป้าหมายตามสถานะความเป็นบิดามารดา ฟีเจอร์ใหม่ เพิ่มการรองรับการกำหนดเป้าหมายตามสถานะความเป็นบิดามารดาในการวางแผนการเข้าถึง ระบบได้เพิ่มฟิลด์ใหม่ parental_statuses ลงใน Targeting สำหรับบริการ ReachPlanService.GenerateReachForecast และเพิ่ม parental_statuses ลงใน PlannableTargeting สำหรับบริการ ReachPlanService.ListPlannableProducts
คำแนะนำ
Recommendation.campaign_specific_app_goal_recommendation คำแนะนำใหม่ แนะนําให้เพิ่มเป้าหมาย Conversion ของแอปเฉพาะแคมเปญ ระบบจะใช้ทรัพยากร EffectiveAutomaticGoal ใหม่เพื่อแสดงเป้าหมายปัจจุบันภายในคําแนะนํานี้
รายงาน
Metrics.original_conversion_value ช่องใหม่ แสดงมูลค่า Conversion เดิมจาก Conversion ที่เสนอราคาได้ นี่คือมูลค่าที่ไม่ได้ปรับของ Conversion ก่อนที่จะใช้การปรับกฎมูลค่า เช่น กฎมูลค่า Conversion หรือการปรับเป้าหมายวงจรลูกค้า
สถิติการเป็นสมาชิกโปรแกรมสะสมคะแนน ฟีเจอร์ใหม่ เพิ่มการรองรับการแบ่งกลุ่มสถิติตามสถานะโปรแกรมการเป็นสมาชิกสะสมคะแนนของผู้ใช้ และเพิ่มมิติข้อมูลหลักของการเป็นสมาชิกสะสมคะแนนสำหรับกฎมูลค่า Conversion ดังนี้
  • เพิ่มกลุ่ม Segments.loyalty_membership เพื่อรองรับการแบ่งกลุ่มเมตริกรายงานตามระดับโปรแกรมสะสมคะแนนของผู้ใช้ที่ทํา Conversion
  • เพิ่มมิติข้อมูลหลัก LOYALTY_MEMBERSHIP เพื่อระบุเมื่อตรงตามเงื่อนไขการเป็นสมาชิกโปรแกรมสะสมคะแนนสำหรับกฎมูลค่า Conversion
การกำหนดเป้าหมาย
vertical_ads_item_bid ประเภทเกณฑ์ใหม่ เพิ่มประเภทเกณฑ์ vertical_ads_item_bid ใหม่ลงใน AdGroupCriterion.criterion

v25 (22-07-2026)

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

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

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

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

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

ฟีเจอร์และการอัปเดต ประเภท คำอธิบาย
โฆษณา
AssetAutomationType.GENERATE_ANIMATED_IMAGES_FROM_OTHER_ASSETS ค่า enum / ลักษณะการทำงานใหม่ มีห้องว่างช่วงDemandGenMultiAssetAds หากเปิดใช้ ระบบจะสร้างภาพเคลื่อนไหวโดยใช้ภาพที่ไม่เคลื่อนไหวเป็นอินพุต DemandGenMultiAssetAds ใหม่จะเลือกใช้โดยค่าเริ่มต้นตั้งแต่ API เวอร์ชันนี้เป็นต้นไป
ความสามารถในการเปลี่ยนแปลงข้อมูลเนื้อหาสังเคราะห์ การเปลี่ยนแปลงพฤติกรรม ตอนนี้ Asset.synthetic_content_info และ Ad.synthetic_content_info สามารถเปลี่ยนแปลงได้อย่างเต็มที่ใน v25, v24 และ v23
แคมเปญ
เป้าหมายการรักษาลูกค้าในโปรแกรมสะสมคะแนน ฟีเจอร์ / การตั้งค่าใหม่ เพิ่มการรองรับเป้าหมายการรักษาลูกค้าจากโปรแกรมสะสมคะแนน ซึ่งช่วยให้ผู้ลงโฆษณาเพิ่มประสิทธิภาพแคมเปญเพื่อรักษาลูกค้าที่เป็นสมาชิกโปรแกรมสะสมคะแนนได้
เป้าหมายการได้ลูกค้าใหม่ ฟีเจอร์ / การตั้งค่าใหม่ การรองรับเป้าหมายการได้ลูกค้าใหม่ที่อัปเดตแล้วใน Google Ads API เพื่อให้สอดคล้องกับสคีมาเป้าหมายแบบรวมที่ปรับปรุงใหม่
Conversion
การระบุแหล่งที่มาของ Conversion ของบุคคลที่สามใน YouTube ช่องใหม่ เพิ่มการรองรับการยืนยันการระบุแหล่งที่มาของ Conversion ของ YouTube โดยใช้พาร์ทเนอร์บุคคลที่สาม ดูข้อมูลเพิ่มเติมได้ที่บทความในศูนย์ช่วยเหลือ
ทั่วไป
ContactDetails.phone_number_extension ช่องใหม่ เพิ่มลงในแหล่งข้อมูล LocalServicesLead แล้ว
IncentiveError ค่า enum / ข้อผิดพลาดใหม่ เพิ่มรหัสข้อผิดพลาดใหม่ที่เฉพาะเจาะจงสำหรับความล้มเหลวในการแลกรับสิ่งจูงใจ
  • BILLING_COUNTRY_NOT_ELIGIBLE (ประเทศสำหรับการเรียกเก็บเงินของลูกค้าไม่มีสิทธิ์รับสิ่งจูงใจ)
  • USER_IS_MCC_MANAGER (ผู้ใช้เป็นบัญชีดูแลจัดการและไม่สามารถแลกรับสิ่งจูงใจได้)
  • USER_SUSPENDED (บัญชีลูกค้าถูกระงับ)
  • MAX_PENDING_INCENTIVES (ลูกค้ามีสิ่งจูงใจที่รอดำเนินการครบตามจำนวนสูงสุดแล้ว)
  • ACCOUNT_HAD_RECENT_SPEND (บัญชีมีการใช้จ่ายล่าสุดและไม่มีสิทธิ์)
  • MAX_INCENTIVES_REDEEMED_FROM_OFFER (ลูกค้าแลกรับสิ่งจูงใจจากข้อเสนอนี้ถึงจำนวนสูงสุดแล้ว)
  • MISMATCHING_BILLING_COUNTRY_CODE (รหัสประเทศสำหรับการเรียกเก็บเงินที่ระบุในคำขอไม่ตรงกับประเทศในบัญชีของลูกค้า)
การวางแผน
รายละเอียดช่อง YouTube ในข้อมูลเชิงลึกเกี่ยวกับเทรนด์ ช่องใหม่ เพิ่มการรองรับรายละเอียดช่อง YouTube ของวิดีโอที่เกี่ยวข้องมากขึ้นเมื่อค้นหาข้อมูลเชิงลึกที่กำลังมาแรง เราได้เพิ่มฟิลด์ใหม่ channel_id, channel_name และ channel_url ลงใน YouTubeVideoAttributeMetadata แล้ว
YouTubeChannelInsights.data_sharing_consent_given ช่องใหม่ เพิ่มไปที่ YouTubeChannelInsights แล้ว ซึ่งจะเป็นจริงในกรณีที่ครีเอเตอร์ยินยอมให้แชร์ข้อมูลที่ไม่ใช่แบบสาธารณะ หากเป็นเช่นนั้น ระบบจะป้อนข้อมูลในช่องต่อไปนี้
รายงาน
ad_sub_format_type กลุ่มใหม่ แสดงรายละเอียดของโฆษณาในสตรีมแบบข้ามไม่ได้ของ YouTube ตามระยะเวลา
  • INSTREAM_NON_SKIPPABLE_STANDARD (โฆษณาในสตรีมแบบข้ามไม่ได้ที่มีระยะเวลามาตรฐาน)
  • INSTREAM_NON_SKIPPABLE_MAX30_SEC (โฆษณาในสตรีมแบบข้ามไม่ได้ที่มีความยาวไม่เกิน 30.99 วินาที)
  • INSTREAM_NON_SKIPPABLE_MAX60_SEC (โฆษณาในสตรีมแบบข้ามไม่ได้ที่มีความยาวไม่เกิน 60.99 วินาที)
ต้องเลือกกลุ่มนี้พร้อมกับ ad_format_type เสมอ โดยเลือกได้ด้วย AdGroup, AdGroupAd, Campaign, Customer, Video และ VideoEnhancement
เมตริกโซเชียลสำหรับวิดีโอโดยเฉพาะ ฟิลด์ / เมตริกใหม่ เพิ่มเมตริกโซเชียลสำหรับวิดีโอโดยเฉพาะเพื่อช่วยผู้ลงโฆษณาติดตามการมีส่วนร่วมของผู้ใช้ (ความคิดเห็น การกดชอบ และการแชร์) สำหรับโฆษณา Shorts บน YouTube ดังนี้ โดยพร้อมใช้งานใน AdGroup, AdGroupAd, Asset, Campaign, Customer และ Video

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

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

v24.2 (24-06-2026)

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

ฟีเจอร์และการอัปเดต ประเภท คำอธิบาย
โฆษณา
AssetAutomationType.GENERATE_LANDING_PAGE_TEXT ค่า enum ใหม่ สร้างข้อมูลข้อความจากหน้า Landing Page เพื่อแสดงในแผงการมีส่วนร่วมสำหรับอินสแตนซ์ DemandGenVideoResponsiveAd (ซึ่งเลือกใช้โดยค่าเริ่มต้นตั้งแต่ API เวอร์ชันนี้)
ชิ้นงาน
AssetGroup.google_local_services_info ช่องใหม่ เพิ่มเพื่อรองรับข้อมูลโฆษณาบริการในพื้นที่ (รหัสหมวดหมู่และข้อความไฮไลต์) ในแคมเปญ Performance Max
AssetGroupSignal.local_services_id ช่องใหม่ เพิ่มเพื่อรองรับสัญญาณรหัสบริการของโฆษณาบริการในพื้นที่ในแคมเปญ Performance Max
AssetGroupSignal.vertical_ads_item_group_rule_list ช่องใหม่ เพิ่มเพื่อรองรับกฎกลุ่มสินค้าโฆษณาวิดีโอแนวตั้งสำหรับการเลือกสินค้าจากฟีดวิดีโอแนวตั้งที่แนบมาในแคมเปญ Performance Max ฟีเจอร์นี้พร้อมใช้งานสำหรับบัญชีในรายการที่อนุญาตเท่านั้น
AssetGroupErrorEnum.CANNOT_REMOVE_ALL_ASSET_GROUPS_FROM_CAMPAIGN ค่า enum / ข้อผิดพลาดใหม่ แสดงเมื่อพยายามนำกลุ่มชิ้นงานทั้งหมดออกจากแคมเปญ
AssetGroupSignalErrorEnum.CANNOT_REMOVE_ALL_SIGNALS ค่า enum / ข้อผิดพลาดใหม่ แสดงเมื่อพยายามนำสัญญาณทั้งหมดออกจากกลุ่มชิ้นงาน
แคมเปญ
Campaign.PmaxCampaignSettings.local_services_pmax_campaign_settings
Campaign.PmaxCampaignSettings.local_services_enabled
ช่องใหม่ ช่วยระบุแคมเปญ Performance Max ของบริการในพื้นที่
AdGroup.DemandGenAdGroupSettings.DemandGenChannelControls.DemandGenSelectedChannels.maps ช่องใหม่ รวม Google Maps ไว้ในช่องที่เลือกได้สําหรับกลุ่มโฆษณา Demand Gen
CampaignCriterionErrorEnum.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN ค่า enum / ข้อผิดพลาดใหม่ แสดงเมื่อพยายามนำสถานที่ตั้งทั้งหมดออกจากแคมเปญ Performance Max สำหรับบริการในพื้นที่
SmartCampaignErrorEnum.CREATION_FAILED ค่า enum / ข้อผิดพลาดใหม่ แสดงเมื่อพยายามสร้าง Smart Campaign ใหม่
Conversion
ConversionOrigin.LOCAL_SERVICES_ADS
ConversionActionType.LOCAL_SERVICES_ADS
ค่า enum ใหม่ แสดง Conversion ที่เกิดขึ้นเมื่อผู้ใช้คลิกโฆษณาบริการในพื้นที่และโทร ส่งข้อความ หรือจองกับผู้ลงโฆษณา
การทดสอบ
COMPARE_CAMPAIGNS
PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION
ค่า enum ใหม่ เพิ่มการรองรับExperimentType ประเภทใหม่ดังนี้
  • COMPARE_CAMPAIGNS: สำหรับการทดสอบการผสมผสานแคมเปญและการทดสอบ Performance Max ที่กําหนดเองซึ่งเปรียบเทียบแคมเปญหลายรายการประเภทเดียวกันหรือต่างประเภทในการทดสอบเดียว
  • PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION: สำหรับการทดสอบการเพิ่มประสิทธิภาพ Performance Max สำหรับการปรับแต่งข้อความและ Final URL Expansion
ทั่วไป
Asset.synthetic_content_info
Ad.synthetic_content_info
ช่องใหม่ มีการรับรองสำหรับเนื้อหาสังเคราะห์/เนื้อหาที่ AI สร้างขึ้น โดยแบ่งออกเป็น advertiser_attestation (การประกาศที่ผู้ลงโฆษณาให้ไว้โดยตรง) และ system_attestation (การรับรองที่ระบบตรวจพบโดยอัตโนมัติหรือที่ระบบให้ไว้)

ฟีเจอร์นี้ได้รับการพอร์ตย้อนกลับไปยังเวอร์ชัน 23 และ 22 แล้ว

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

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

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