Hãy tham gia cùng chúng tôi trong sự kiện phát trực tiếp trên Discord trên máy chủ Cộng đồng quảng cáo và đo lường của Google và trên YouTube vào ngày 25 tháng 6 lúc 10:00 (giờ miền Đông)! Chúng tôi sẽ thảo luận về các tính năng mới được thêm vào trong API Google Ads phiên bản 24.2.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Ghi chú phát hành

Hãy tham khảo Các tính năng ngừng hoạt động để xem danh sách mới nhất về các tính năng hiện tại và dự kiến ngừng hoạt động.

Phiên bản lớn và phiên bản nhỏ của v24

API Google Ads phiên bản 24 có các tính năng mới, nội dung cập nhật và thay đổi mang tính đột phá sau đây.

Phiên bản 24.2 (24/6/2026)

Các tính năng mới và nội dung cập nhật sau đây đã được thêm vào Google Ads API phiên bản 24.2. Các phiên bản phụ như v24.2 không chứa các thay đổi có thể gây lỗi.

Tính năng và thông tin cập nhật	Loại	Mô tả
Quảng cáo
`AssetAutomationType.GENERATE_LANDING_PAGE_TEXT`	Giá trị enum mới	Tạo thông tin dạng văn bản từ trang đích để hiển thị trong bảng điều khiển tương tác cho các phiên bản `DemandGenVideoResponsiveAd` (được chọn sử dụng theo mặc định kể từ phiên bản API này).
Thành phần
`AssetGroup.google_local_services_info`	Trường mới	Đã thêm thông tin hỗ trợ cho Quảng cáo dịch vụ địa phương (mã danh mục và chú thích) trong chiến dịch Tối đa hoá hiệu suất.
`AssetGroupSignal.local_services_id`	Trường mới	Đã thêm để hỗ trợ tín hiệu mã dịch vụ của Quảng cáo dịch vụ địa phương trong chiến dịch Tối đa hoá hiệu suất.
`AssetGroupSignal.vertical_ads_item_group_rule_list`	Trường mới	Đã thêm để hỗ trợ các quy tắc nhóm mặt hàng quảng cáo dọc để chọn mặt hàng từ nguồn cấp dữ liệu dọc được đính kèm trong chiến dịch Tối đa hoá hiệu suất. Tính năng này chỉ dành cho những tài khoản có trong danh sách cho phép.
`AssetGroupErrorEnum.CANNOT_REMOVE_ALL_ASSET_GROUPS_FROM_CAMPAIGN`	Giá trị enum mới / lỗi	Trả về khi bạn cố gắng xoá tất cả nhóm thành phần khỏi một chiến dịch.
`AssetGroupSignalErrorEnum.CANNOT_REMOVE_ALL_SIGNALS`	Giá trị enum mới / lỗi	Trả về khi bạn cố gắng xoá tất cả tín hiệu khỏi một nhóm thành phần.
Chiến dịch
`Campaign.PmaxCampaignSettings.local_services_pmax_campaign_settings` `Campaign.PmaxCampaignSettings.local_services_enabled`	Trường mới	Hỗ trợ xác định chiến dịch Tối đa hoá hiệu suất cho Dịch vụ địa phương.
`AdGroup.DemandGenAdGroupSettings.DemandGenChannelControls.DemandGenSelectedChannels.maps`	Trường mới	Bao gồm Google Maps trong số các kênh có thể chọn cho nhóm quảng cáo Tạo nhu cầu.
`CampaignCriterionErrorEnum.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN`	Giá trị enum mới / lỗi	Trả về khi bạn cố gắng xoá tất cả vị trí khỏi chiến dịch Tối đa hoá hiệu suất cho dịch vụ tại địa phương.
`SmartCampaignErrorEnum.CREATION_FAILED`	Giá trị enum mới / lỗi	Trả về khi bạn cố gắng tạo chiến dịch Thông minh mới.
Lượt chuyển đổi
`ConversionOrigin.LOCAL_SERVICES_ADS` `ConversionActionType.LOCAL_SERVICES_ADS`	Giá trị enum mới	Đại diện cho những lượt chuyển đổi xảy ra khi người dùng nhấp vào một quảng cáo dịch vụ địa phương và gọi điện, nhắn tin hoặc đặt lịch hẹn với nhà quảng cáo.
Thử nghiệm
`COMPARE_CAMPAIGNS` `PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION`	Giá trị enum mới	Thêm tính năng hỗ trợ cho các loại `ExperimentType` mới: `COMPARE_CAMPAIGNS`: Đối với thử nghiệm kết hợp chiến dịch và thử nghiệm tuỳ chỉnh về chiến dịch Tối đa hoá hiệu suất, hãy so sánh nhiều chiến dịch cùng loại hoặc khác loại trong một thử nghiệm duy nhất. `PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION`: Đối với các thử nghiệm tối ưu hoá chiến dịch Tối đa hoá hiệu suất cho tính năng tuỳ chỉnh văn bản và Mở rộng URL cuối cùng.
Giải pháp chung
`Asset.synthetic_content_info` `Ad.synthetic_content_info`	Trường mới	Chứa thông tin chứng thực cho nội dung giả tạo/do AI tạo, được chia thành `advertiser_input` (thông tin khai báo do nhà quảng cáo cung cấp trực tiếp) và `system_input` (thông tin chứng thực do hệ thống tự động phát hiện hoặc cung cấp). Tính năng này đã được chuyển ngược về phiên bản 23 và 22. Để giúp bạn lập kế hoạch cho công việc tích hợp sắp tới cho phiên bản 25, giao diện để thay đổi các trường chứng thực của nhà quảng cáo sẽ được ra mắt sớm cho phiên bản 22 trở lên. Giao diện này xuất hiện trong các phiên bản này, nhưng `synthetic_content_info.advertiser_attestation.status` và `synthetic_content_info.advertiser_attestation.source` sẽ không thay đổi đối với các phiên bản này. Nếu bạn cố gắng thực hiện một yêu cầu biến đổi trên một trong hai trường này, thì một trong các lỗi sau sẽ được trả về: "Trường mà bạn cố gắng thay đổi là trường không thể thay đổi" hoặc "Bạn không thể đặt trường". Các trường này sẽ hoàn toàn có thể thay đổi bắt đầu từ phiên bản 25. Bạn nên sử dụng giao diện này ngay bây giờ để tạo và kiểm thử logic nội bộ, nhờ đó hệ thống của bạn sẽ sẵn sàng cho các chức năng ghi đầy đủ khi phiên bản 25 ra mắt.
Uỷ quyền nhiều bên	Tính năng mới	Giai đoạn thử nghiệm: Tính năng này hiện đang trong giai đoạn thử nghiệm và có thể thay đổi trong các bản phát hành sau này. Thêm tính năng hỗ trợ cho quy trình đánh giá Uỷ quyền nhiều bên (MPA): Đã thêm tài nguyên `MultiPartyAuthReview` và `MultiPartyAuthReviewService` tương ứng. Thêm enum `MultiPartyAuthReviewStatus` để theo dõi trạng thái xem xét. Đã thêm `CustomerUserAccess.pending_multi_party_auth_review` để liên kết đến một bài đánh giá đang chờ xử lý. Đã thêm `MutateCustomerUserAccessResult.multi_party_auth_review` và `MutateCustomerUserAccessInvitationResult.multi_party_auth_review` để trả về tên tài nguyên bài đánh giá được liên kết. Đã thêm `MultiPartyAuthReviewError` cho các lỗi xác thực. Tính năng này đã được chuyển ngược về v23.3, v22.2 và v21.2.
`IncentiveService.FetchIncentive`	Thay đổi về hành vi	Khi một địa chỉ email không hợp lệ được cung cấp trong yêu cầu, phương thức này hiện sẽ chuyển về việc trả về các ưu đãi mặc định một cách suôn sẻ thay vì gửi lỗi `AuthenticationError.INVALID_EMAIL_ADDRESS`.
Lập kế hoạch
`GenerateCreatorInsightsRequest.search_topics`	Trường mới	Đã thêm vào dịch vụ `ContentCreatorInsightsService.GenerateCreatorInsights`. Lựa chọn này tìm kiếm những nhà sáng tạo nói về một chủ đề ở quốc gia được chỉ định trong `country_locations` (chỉ hỗ trợ tìm kiếm ở một quốc gia).
`CREATOR_TOPIC_INSIGHTS`	Giá trị enum mới	Được thêm vào `InsightsKnowledgeGraphEntityCapabilities` để biểu thị các thực thể dùng để tìm kiếm nhà sáng tạo nói về một chủ đề. Bạn nên sử dụng các thực thể này trong trường `search_topics`. Được truy xuất bằng `AudienceInsightsService.ListAudienceInsightsAttributes`.
`KnowledgeGraphEntitySearchOptions`	Loại / lựa chọn mới	Chứa các lựa chọn tìm kiếm bổ sung cho các chủ đề trong `ListAudienceInsightsAttributes`, bao gồm cả các lựa chọn để truy xuất tất cả chủ đề được hỗ trợ dưới dạng thuộc tính của nhà sáng tạo và lọc theo chức năng.
`GenerateCreatorInsightsRequest.supplemental_data` `GenerateTrendingInsightsRequest.supplemental_data`	Trường mới	Giá trị nhập không bắt buộc cho các phương thức `ContentCreatorInsightsService`. Việc cung cấp trường này sẽ điền thêm các vị trí hoặc thuộc tính của nhà sáng tạo vào phản hồi.
`local_creator_insights` `related_local_creators`	Trường mới	Được điền sẵn khi `supplemental_data` chứa enum `LOCAL_CREATOR_DATA`. Hiển thị những nhà sáng tạo địa phương đã xem hoặc sinh sống ở quốc gia được chọn và đồng ý chia sẻ dữ liệu vị trí.
`GenerateTrendingInsightsRequest.sub_country_locations`	Trường mới	Đã thêm vào `ContentCreatorInsightsService.GenerateTrendingInsights`, cho phép tìm kiếm thông tin chi tiết về xu hướng bằng cách sử dụng vị trí quốc gia và vị trí cấp dưới quốc gia.
Báo cáo
`PerformanceMaxPlacementView`	Phần mở rộng về phân khúc	Được `ad_network_type` tạo thành phân đoạn.
Mua sắm
`Campaign.ShoppingSetting.ignore_brand_exclusion_in_shopping_ads`	Trường mới	Nếu đúng, tiêu chí loại trừ thương hiệu sẽ bị bỏ qua đối với quảng cáo Mua sắm. Chỉ được hỗ trợ cho chiến dịch Mua sắm.
Nhắm mục tiêu
`CriterionErrorEnum.CANNOT_TARGET_LANGUAGE`	Giá trị enum mới / lỗi	Trả về khi cố gắng nhắm đến một ngôn ngữ không được phép.
Video
`DataLink.youtube_link_metadata`	Trường mới	Chứa `brand_channel_id` để chỉ định mã nhận dạng của kênh thương hiệu được liên kết trên YouTube.

Phiên bản 24.1 (13/5/2026)

Google Ads API phiên bản 24.1 có các tính năng mới và nội dung cập nhật sau đây. Các phiên bản phụ như v24.1 không chứa các thay đổi có thể gây lỗi.

Tính năng và thông tin cập nhật	Loại	Mô tả
Quảng cáo
`DemandGenMultiAssetAdInfo.classic_display_images`	Trường mới	Hình ảnh hiển thị tuỳ chỉnh được tải lên và phân phát mà không cần có thêm thành phần thích ứng.
Thử nghiệm
`ADOPT_AI_MAX` `ADOPT_BROAD_MATCH_KEYWORDS` `OPTIMIZE_ASSETS` `PMAX_REPLACEMENT_SHOPPING`	Giá trị enum mới	Thêm tính năng hỗ trợ cho các loại `ExperimentType` mới: `ADOPT_AI_MAX`: Đối với những thử nghiệm kiểm tra cách bộ tính năng Tối đa hoá AI có thể giúp bạn thu hút thêm nhiều khách hàng nhờ AI của Google và từ khoá khớp mở rộng. `ADOPT_BROAD_MATCH_KEYWORDS`: Đối với những thử nghiệm kiểm tra mức độ ảnh hưởng của từ khoá khớp mở rộng đến số lượt tìm kiếm mà quảng cáo của bạn xuất hiện. `OPTIMIZE_ASSETS`: Đối với thử nghiệm tuỳ chỉnh để tối ưu hoá thành phần. `PMAX_REPLACEMENT_SHOPPING`: Đối với những thử nghiệm kiểm tra hiệu suất của chiến dịch Mua sắm so với chiến dịch Tối đa hoá hiệu suất.
`Experiment.video_experiment`	Trường mới	Hỗ trợ cấu hình cho các thử nghiệm `YOUTUBE_CUSTOM` hiện có bao gồm chiến dịch Video.
`ExperimentArm.asset_testing_info` `ExperimentArm.asset_groups` `ExperimentArm.performance_max_experiment_arm_info`	Trường mới	Hiển thị các trường để hỗ trợ thử nghiệm thành phần, nhóm thành phần và chế độ cài đặt chiến dịch Tối đa hoá hiệu suất trong các nhóm thử nghiệm: `asset_testing_info`: Thông tin chi tiết về các thành phần được liên kết với bản sao thử nghiệm của quảng cáo. `asset_groups`: Danh sách nhóm thành phần trong nhóm thử nghiệm cho các thử nghiệm Tối ưu hoá thành phần. `performance_max_experiment_arm_info`: Chế độ cài đặt cho chiến dịch Tối đa hoá hiệu suất trong thử nghiệm `PMAX_REPLACEMENT_SHOPPING`.
Giải pháp chung
`CustomerUserAccess.passkey_enabled`	Trường mới	Trường chỉ đọc cho biết liệu người dùng có bật khoá truy cập hay không.
Báo cáo
`mobile_device_platform`	Phân khúc mới	Cho phép phân đoạn báo cáo theo nền tảng của thiết bị người dùng (chẳng hạn như iOS hoặc Android).
`REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED`	Giá trị enum mới / lỗi	Trả về khi độ chi tiết thời gian hằng ngày, hằng giờ hoặc hằng tuần được yêu cầu không được hỗ trợ cho phạm vi ngày của truy vấn (chỉ có sẵn trong 37 tháng gần đây nhất).
`vertical_ads_listing_user_rating` `vertical_ads_listing_venue`	Phân khúc mới	Các phân khúc mới sẽ được dùng cho quảng cáo dọc.
`user_rating`, `venue`, `event_participant_display_name`	Tiêu chí lọc mới	Hỗ trợ lọc trong `VerticalAdsItemGroupRuleInfo` cho tài nguyên `SharedCriterion`.
Chỉ số thử nghiệm của nhóm đối chứng/nhóm thử nghiệm	Trường mới	Đã thêm các giá trị kiểm soát (`control_clicks`, v.v.), giá trị thử nghiệm (`clicks`, v.v.), ước tính điểm (`clicks_point_estimate`, v.v.), sai số (`clicks_margin_of_error`, v.v.) và giá trị p (`clicks_p_value`, v.v.) trên 7 nhóm chỉ số chính (Lượt nhấp, Lượt hiển thị, Chi phí, Lượt chuyển đổi, Chi phí mỗi lượt chuyển đổi, Giá trị lượt chuyển đổi, Giá trị lượt chuyển đổi trên mỗi chi phí).
Chỉ số thay đổi tuyệt đối về lượt chuyển đổi	Trường mới	Hỗ trợ `Conversions` ước tính chênh lệch tuyệt đối bằng cách sử dụng các trường ước tính điểm, tỷ lệ sai số và giá trị p.
Nhắm mục tiêu
`CriterionErrorEnum.CANNOT_EXCLUDE_ALL_TARGETS`	Giá trị enum mới / lỗi	Trả về khi bạn cố gắng loại trừ tất cả các mục tiêu nhân khẩu học.
Video
`ThirdPartyViewabilityIntegrationPartnerEnum.ZEFR`	Giá trị enum mới	Đã xuất bản ZEFR với tư cách là đối tác tích hợp bên thứ ba về khả năng xem.
`DataLink.youtube_video.channel_id`	Trường mới	Hiển thị mã nhận dạng kênh YouTube được liên kết với mối liên kết dữ liệu.

Phiên bản 24 (22/4/2026)

Các tính năng mới, nội dung cập nhật và thay đổi có thể gây lỗi sau đây đã được thêm vào Google Ads API phiên bản 24 (một bản phát hành chính).

Hãy xem phần Nâng cấp lên phiên bản mới nhất để được hướng dẫn.

Thay đổi có thể gây lỗi

Trạng thái ban đầu	Trạng thái mới	Loại thay đổi	Hướng dẫn triển khai
Quảng cáo
Không bắt buộc `videos` và `logo_images` trong `DemandGenVideoResponsiveAdInfo`	Các trường bắt buộc	Thay đổi về hành vi	Cung cấp `videos` và `logo_images` khi tạo hoặc thay đổi quảng cáo Tạo nhu cầu dạng video thích ứng.
Không bắt buộc `videos`, `business_name` và `logo_images` trong `VideoResponsiveAdInfo`	Các trường bắt buộc	Thay đổi về hành vi	Cung cấp `videos`, `business_name` và `logo_images` khi tạo hoặc thay đổi quảng cáo dạng video thích ứng. Xin lưu ý rằng `VideoResponsiveAdInfo` hiện có thể thay đổi.
Chiến dịch
`Campaign.video_brand_safety_suitability`	Không có	Xoá bỏ	Đã xoá chế độ kiểm soát mức độ phù hợp ở cấp chiến dịch. Bạn vẫn có thể sử dụng mức độ phù hợp và an toàn cho thương hiệu ở cấp khách hàng. Thay vào đó, hãy sử dụng `Customer.video_brand_safety_suitability`.
Lượt chuyển đổi
`UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS`	Không có	Xoá bỏ	Danh mục người dùng đăng ký chương trình khách hàng thân thiết đã bị xoá. Xoá các thông tin tham chiếu đến mã.
Lập kế hoạch
Loại `InsightsAudienceAttributeGroup` cho `topic_audience_combinations`	Kiểu `common.InsightsAudienceAttributeGroup`	Thay đổi về hành vi / thay đổi về loại	Bạn phải cập nhật các chế độ tích hợp thư viện ứng dụng có kiểu để sử dụng không gian tên tài nguyên mới.
Trường `youtube_select_lineups` trong `ReachPlanService.ListPlannableProducts`	Không có	Xoá bỏ	Chuyển sang dùng danh sách phát từ `youtube_select_lineup_targeting`.
Trường `is_brand_connect_creator` trong `ContentCreatorInsightsService.GenerateCreatorInsights` và `GenerateTrendingInsights`	Không có	Xoá bỏ	Thay vào đó, hãy kiểm tra xem nhà sáng tạo có `CREATOR_PARTNERSHIPS` trong `partnership_opportunities` hay không.
`geo_modifiers` và `biddable_keywords` trong `KeywordPlanIdeaService.GenerateKeywordForecastMetrics`	`geo_target_constants` và `keywords`	Đổi tên / xoá	Được thay thế bằng `CampaignToForecast.geo_target_constants[]` và `ForecastAdGroup.keywords[]`.
Các trường kế hoạch / dự đoán từ khoá không được dùng nữa trong `GenerateKeywordForecastMetrics`	Không có	Xoá bỏ	Đã xoá các trường và loại kế hoạch / dự báo sau: `CampaignToForecast.keyword_plan_network` `CampaignToForecast.negative_keywords` và `ForecastAdGroup.negative_keywords` `ForecastAdGroup.max_cpc_bid_micros` `BiddableKeyword` `CriterionBidModifier` `KeywordForecastMetrics.impressions` `KeywordForecastMetrics.click_through_rate` Cập nhật các chế độ tích hợp cho phù hợp.
Báo cáo
Phân khúc `ad_sub_network_type` trong `campaign_budget`	Không có	Xoá bỏ	Đã xoá phân đoạn `ad_sub_network_type` cho tài nguyên `campaign_budget`.
`click_type` phân khúc trong chế độ xem thành phần	Không có	Xoá bỏ	Xoá phân khúc khỏi chế độ xem `AdGroupAsset`, `CampaignAsset` và `CustomerAsset`.
Video
Được phép có lỗi một phần trong `ShareablePreviewService.GenerateShareablePreviews`	Không có lỗi một phần	Thay đổi về hành vi	Các yêu cầu sẽ không thành công và gây ra lỗi nếu có mã nhận dạng nào trong đó không xác thực được.
`ShareablePreviewError` mã cũ: `ASSET_GROUP_DOES_NOT_EXIST_UNDER_THIS_CUSTOMER` `TOO_MANY_ASSET_GROUPS_IN_REQUEST`	`MutateErrorEnum.RESOURCE_NOT_FOUND` `ShareablePreviewError.TOO_MANY_RESOURCES_IN_REQUEST`	Đổi tên / thay đổi hành vi	Mã lỗi được trả về cho nhóm thành phần được sửa đổi để phù hợp với lỗi quảng cáo của nhóm quảng cáo. Cập nhật logic bắt lỗi xác thực.

Các tính năng và bản cập nhật (không làm gián đoạn)

Tính năng và thông tin cập nhật	Loại	Mô tả
Quảng cáo
Khả năng biến đổi của `VideoResponsiveAdInfo`	Thay đổi về hành vi	Các đối tượng thông tin của quảng cáo thích ứng dạng video hiện có thể thay đổi.
Thành phần
`travel_feed_data` trong `AssetSet`	Trường mới	Đã thêm để truy xuất các thuộc tính của tài sản trong nguồn cấp dữ liệu du lịch (`hotel_center_account_id`, `merchant_center_id`, `partner_center_id`, `subset_id`, `travel_feed_vertical_type`).
Chiến dịch
`Campaign.view_through_conversion_optimization_enabled`	Trường mới	Cho phép bật tính năng Tối ưu hoá lượt chuyển đổi từ lượt xem hết (VTC) (mặc định là `false`) trong chiến dịch Tạo nhu cầu và chiến dịch Quảng cáo ứng dụng.
`CampaignCriterion.gender`	Tính năng mới	Đã bật tiêu chí loại trừ theo giới tính cho chiến dịch Tối đa hoá hiệu suất trên tất cả các phiên bản Google Ads API.
Lượt chuyển đổi
Các loại lượt chuyển đổi của chiến dịch Tạo khách hàng tiềm năng	Giá trị enum mới	Đã thêm các enum loại hành động chuyển đổi GA4/Firebase mới trong `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`
Giải pháp chung
`UserListErrorEnum.DUPLICATE_LOOKALIKE`	Giá trị enum mới / lỗi	Trả về khi bạn cố gắng tạo nhiều danh sách đối tượng tương tự giống hệt nhau.
Lập kế hoạch
`ProductCoreAttributes` trường trong `ListPlannableProductsResponse`	Trường mới	Đã thêm nội dung mô tả sản phẩm có thể lập kế hoạch, mục tiêu tiếp thị, mô hình chi phí và phương thức mua vào `ProductCoreAttributes` trong `ListPlannableProductsResponse`.
Báo cáo
`CartDataSalesView`	Tài nguyên báo cáo mới	Hiển thị báo cáo phân đoạn chỉ số lượt chuyển đổi theo sản phẩm cụ thể đã bán (thương hiệu, v.v.) ngoài sản phẩm được nhấp vào.
Chỉ số không thể đặt giá thầu	Trường mới	Đã thêm các chỉ số không thể đặt giá thầu (các chỉ số cho biết những lượt chuyển đổi mà chiến dịch không tối ưu hoá) vào tất cả các tài nguyên phù hợp: `all_average_cart_size` `all_average_order_value_micros` `all_cost_of_goods_sold_micros` `all_cross_sell_cost_of_goods_sold_micros` `all_cross_sell_gross_profit_micros` `all_cross_sell_revenue_micros` `all_cross_sell_units_sold` `all_gross_profit_margin` `all_gross_profit_micros` `all_lead_cost_of_goods_sold_micros` `all_lead_gross_profit_micros` `all_lead_revenue_micros` `all_lead_units_sold` `all_orders` `all_revenue_micros` `all_units_sold`
`conversion_attribution_event_type`	Phân khúc mới	Đã thêm vào `ShoppingPerformanceView`.
Mua sắm
Chiến dịch quảng cáo ứng dụng trên `ShoppingProduct`	Tính năng mới	Chiến dịch Quảng cáo ứng dụng được hỗ trợ trong tài nguyên `ShoppingProduct`. Không được hỗ trợ trạng thái và vấn đề về ghi chú.
Lọc sản phẩm dựa trên thẻ	Tính năng mới	Giới thiệu tính năng lọc bằng cách sử dụng biểu thức tập hợp logic một cách linh động: Đã thêm các loại tiêu chí `RETAIL_FILTER_BUNDLE` và `RETAIL_FILTER`. Đã thêm loại nhóm được chia sẻ `RETAIL_FILTER`. Đã thêm trường `retail_filter_bundle` vào `AdGroupCriterion`. Đã thêm trường `retail_filter` vào `SharedCriterion`. Thêm `RETAIL` vào `ListingGroupFilterListingSource`. Thêm phương diện `RetailFilter` vào `AssetGroupListingGroupFilter`. Đã thêm các lỗi xác thực mới có liên quan trong `CriterionError` và `AssetGroupListingGroupFilterError`. Tính năng này chỉ dành cho những tài khoản có trong danh sách cho phép.

Phiên bản lớn và nhỏ v23

Google Ads API phiên bản 23 có các tính năng mới, nội dung cập nhật và thay đổi có thể gây lỗi sau đây.

Phiên bản 23.3 (24/6/2026)

Các tính năng mới và nội dung cập nhật sau đây đã được thêm vào Google Ads API phiên bản 23.3. Các phiên bản phụ như v23.3 không chứa các thay đổi gây lỗi.

Tính năng và thông tin cập nhật Loại Mô tả

Giải pháp chung

Tính năng và thông tin cập nhật	Loại	Mô tả
Giải pháp chung
`Asset.synthetic_content_info` `Ad.synthetic_content_info`	Trường mới	Chứa thông tin chứng thực cho nội dung giả tạo/do AI tạo, được chia thành `advertiser_attestation` (thông tin khai báo do nhà quảng cáo cung cấp trực tiếp) và `system_attestation` (thông tin chứng thực do hệ thống của Google tự động phát hiện hoặc cung cấp). Để giúp bạn lập kế hoạch cho công việc tích hợp sắp tới cho phiên bản 25, giao diện để thay đổi các trường chứng thực của nhà quảng cáo sẽ được ra mắt sớm cho phiên bản 22 trở lên. Giao diện này xuất hiện trong các phiên bản này, nhưng `synthetic_content_info.advertiser_attestation.status` và `synthetic_content_info.advertiser_attestation.source` sẽ không thay đổi đối với các phiên bản này. Nếu bạn cố gắng thực hiện một yêu cầu biến đổi trên một trong hai trường này, thì một trong các lỗi sau sẽ được trả về: "Trường mà bạn cố gắng thay đổi là trường không thể thay đổi" hoặc "Bạn không thể đặt trường". Các trường này sẽ hoàn toàn có thể thay đổi bắt đầu từ phiên bản 25. Bạn nên sử dụng giao diện này ngay bây giờ để tạo và kiểm thử logic nội bộ, nhờ đó hệ thống của bạn sẽ sẵn sàng cho các chức năng ghi đầy đủ khi phiên bản 25 ra mắt.
Phê duyệt nhiều bên	Tính năng mới	Giai đoạn thử nghiệm: Tính năng này hiện đang trong giai đoạn thử nghiệm và có thể thay đổi trong các bản phát hành sau này. Thêm tính năng hỗ trợ cho quy trình xem xét phê duyệt nhiều bên (MPA): Đã thêm tài nguyên `MultiPartyAuthReview` và `MultiPartyAuthReviewService` tương ứng. Thêm enum `MultiPartyAuthReviewStatus` để theo dõi trạng thái xem xét. Đã thêm `CustomerUserAccess.pending_multi_party_auth_review` để liên kết đến một bài đánh giá đang chờ xử lý. Đã thêm `MutateCustomerUserAccessResult.multi_party_auth_review` và `MutateCustomerUserAccessInvitationResult.multi_party_auth_review` để trả về tên tài nguyên bài đánh giá được liên kết. Đã thêm `MultiPartyAuthReviewError` cho các lỗi xác thực.

Asset.synthetic_content_info
Ad.synthetic_content_info

Trường mới

Chứa thông tin chứng thực cho nội dung giả tạo/do AI tạo, được chia thành advertiser_attestation (thông tin khai báo do nhà quảng cáo cung cấp trực tiếp) và system_attestation (thông tin chứng thực do hệ thống của Google tự động phát hiện hoặc cung cấp).

Để giúp bạn lập kế hoạch cho công việc tích hợp sắp tới cho phiên bản 25, giao diện để thay đổi các trường chứng thực của nhà quảng cáo sẽ được ra mắt sớm cho phiên bản 22 trở lên. Giao diện này xuất hiện trong các phiên bản này, nhưng synthetic_content_info.advertiser_attestation.status và synthetic_content_info.advertiser_attestation.source sẽ không thay đổi đối với các phiên bản này.

Nếu bạn cố gắng thực hiện một yêu cầu biến đổi trên một trong hai trường này, thì một trong các lỗi sau sẽ được trả về:

"Trường mà bạn cố gắng thay đổi là trường không thể thay đổi" hoặc "Bạn không thể đặt trường".

Các trường này sẽ hoàn toàn có thể thay đổi bắt đầu từ phiên bản 25. Bạn nên sử dụng giao diện này ngay bây giờ để tạo và kiểm thử logic nội bộ, nhờ đó hệ thống của bạn sẽ sẵn sàng cho các chức năng ghi đầy đủ khi phiên bản 25 ra mắt.

Phê duyệt nhiều bên

Tính năng mới

Thêm tính năng hỗ trợ cho quy trình xem xét phê duyệt nhiều bên (MPA):

Đã thêm tài nguyên MultiPartyAuthReview và MultiPartyAuthReviewService tương ứng.
Thêm enum MultiPartyAuthReviewStatus để theo dõi trạng thái xem xét.
Đã thêm CustomerUserAccess.pending_multi_party_auth_review để liên kết đến một bài đánh giá đang chờ xử lý.
Đã thêm MutateCustomerUserAccessResult.multi_party_auth_review và MutateCustomerUserAccessInvitationResult.multi_party_auth_review để trả về tên tài nguyên bài đánh giá được liên kết.
Đã thêm MultiPartyAuthReviewError cho các lỗi xác thực.

phiên bản 23.2 (25/3/2026)

Các tính năng mới và nội dung cập nhật sau đây đã được thêm vào Google Ads API phiên bản 23.2. Các phiên bản phụ như v23.2 không chứa các thay đổi có thể gây lỗi.

Tính năng và thông tin cập nhật	Loại	Mô tả
Thành phần
`VideoEnhancement`	Tài nguyên mới	Chứa thông tin về quảng cáo dạng video dành riêng cho tính năng nâng cao, chẳng hạn như quảng cáo đó do Google tạo hay do nhà quảng cáo cung cấp. Xem bài viết Giới thiệu về các tính năng cải tiến video để tìm hiểu thêm.
`AppTopCombinationView`	Tài nguyên mới	Tài nguyên chỉ đọc để cung cấp thông tin chi tiết về những kiểu kết hợp thành phần hoạt động hiệu quả nhất trong chiến dịch Quảng cáo ứng dụng.
`CustomerAsset`	Tính năng mới	Thêm chức năng hỗ trợ để truy xuất `CustomerAsset` bằng `field_type` được đặt thành `BUSINESS_LOGO`.
Chiến dịch
`AdGroupAd.start_date_time` `AdGroupAd.end_date_time`	Trường mới	Cung cấp các ràng buộc về lịch biểu chi tiết hơn đối với ngày của chiến dịch. Tính năng này chỉ được hỗ trợ cho một số loại nhóm quảng cáo.
`HotelSettingInfo.disable_hotel_setting`	Trường mới	Cho phép tắt nguồn cấp dữ liệu khách sạn trong chiến dịch Tạo nhu cầu.
Giải pháp chung
`CustomerClientLinkError`	Giá trị enum / lỗi mới	Thêm 2 mã lỗi mới: `MAX_CUSTOMER_LIMIT_REACHED` và `ACCOUNT_CREATION_POLICY_VIOLATION`.
`UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS`	Thay đổi về hành vi	Hiện tại, hệ thống sẽ báo lỗi khi bạn cố gắng sử dụng danh mục loại khách hàng trong danh sách người dùng đã ngừng hoạt động này.
Lập kế hoạch
`GenerateTrendingInsights` `GenerateCreatorInsights`	Tính năng mới	Thêm tính năng hỗ trợ các tổ hợp AND/OR tuỳ chỉnh của thực thể, chủ đề và đối tượng.
`ReachPlanService.GenerateReachForecast`	Giá trị enum mới	Đã thêm các độ tuổi có thể nhắm đến mới, chẳng hạn như `AGE_RANGE_21_44` hoặc `AGE_RANGE_21_49`.
`youtube_select_lineup_targeting`	Trường mới	Đã thêm vào `ReachPlanService.ListPlannableProducts`, thay thế cho `youtube_select_lineups`. Cả hai trường này hiện đều được điền sẵn dữ liệu.
`ReachPlanSurface`	Giá trị enum mới	Đã thêm `IN_STREAM_NON_SKIPPABLE_THIRTY_SECONDS` làm lựa chọn về nền tảng.
`Forecast`	Trường mới	Đã thêm `clicks` cho chiến lược Tối đa hoá số lượt nhấp (CPC) của chiến dịch Tạo nhu cầu trong `ReachPlanService.GenerateReachForecast`.
`partnership_opportunities`	Trường mới	Đã thêm vào `ContentCreatorInsightsService.GenerateCreatorInsights` và `ContentCreatorInsightsService.GenerateTrendingInsights`.
Báo cáo
`biddable_indirect_install_first_in_app_conversion_micros`	Trường mới	Đã thêm vào các tài nguyên `Campaign`, `Customer` và `AdGroup`.
Video
`ShareablePreviewService`	Tính năng mới	Được mở rộng để hỗ trợ bản xem trước của sự kiện phát trực tiếp trên YouTube bằng cách đặt `preview_type` thành `YOUTUBE_LIVE_PREVIEW`. Thêm `UNSUPPORTED_AD_TYPE` và `TOO_MANY_RESOURCES_IN_REQUEST` vào `ShareablePreviewError`. Tính năng này chỉ được hỗ trợ cho một số loại quảng cáo.

phiên bản 23.1 (25/2/2026)

Google Ads API phiên bản 23.1 có các tính năng mới và nội dung cập nhật sau đây. Các phiên bản phụ như v23.1 không chứa các thay đổi có thể gây lỗi.

Tính năng và thông tin cập nhật	Loại	Mô tả
Quản lý tài khoản
`advertising_partner_properties.allowed_domain`	Trường mới	Đã thêm vào tài nguyên `ProductLinkInvitation` và `ProductLink`. Đối tác quảng cáo sẽ chỉ có thể quảng cáo trên miền này.
`Customer.contains_eu_political_advertising`	Trường mới	Truy xuất trạng thái khai báo ở cấp tài khoản về việc tài khoản có chứa quảng cáo chính trị nhắm đến Liên minh Châu Âu hay không, đồng thời trả về một `EuPoliticalAdvertisingStatus`.
Chiến dịch
`Campaign.text_guidelines`	Trường mới	Hỗ trợ thêm nguyên tắc về văn bản. Bạn có thể sử dụng nguyên tắc này với chiến dịch Tối đa hoá hiệu suất và chiến dịch Tìm kiếm để kiểm soát các thành phần văn bản do AI tạo theo cách có lập trình. Trong `text_guidelines`, bạn có thể xác định `term_exclusions` và `messaging_restrictions`.
`CampaignPrimaryStatusReason`	Giá trị enum mới	Thêm `CAMPAIGN_NOT_BOOKED`, `BOOKING_HOLD_EXPIRING`, `BOOKING_HOLD_EXPIRED` và `BOOKING_CANCELLED` để cung cấp các lý do chính về trạng thái cho chiến dịch có chiến lược đặt giá thầu `FIXED_CPM`.
`Campaign.VideoCampaignSettings.reservation_ad_category_self_disclosure` `Campaign.VideoCampaignSettings.booking_details`	Trường mới	Thêm thông tin tự công bố về danh mục quảng cáo đặt trước và thông tin đặt phòng chỉ đọc.
`Campaign.missing_eu_political_advertising_declaration`	Trường mới	Hỗ trợ việc truy vấn và lọc những chiến dịch thiếu thông tin khai báo về việc có chứa quảng cáo chính trị nhắm đến Liên minh Châu Âu hay không.
Lượt chuyển đổi
`ConversionActionCategory.YOUTUBE_FOLLOW_ON_VIEWS`	Giá trị enum mới	Hỗ trợ theo dõi những người dùng xem quảng cáo rồi sau đó xem một video trên cùng kênh.
Giải pháp chung
`CriterionErrorEnum.CANNOT_TARGET_ONLY_UNDETERMINED`	Giá trị enum mới / lỗi	Trả về khi bạn tìm cách chỉ nhắm đến danh mục chưa xác định trong phương diện nhân khẩu học.
Chương trình ưu đãi
`IncentiveErrorEnum`	Giá trị enum / lỗi mới	Thêm 2 mã lỗi mới: `MAX_INCENTIVES_REDEEMED` và `ACCOUNT_TOO_OLD`. Những lỗi này có thể được trả về cho các yêu cầu được thực hiện từ ngày 11 tháng 3 năm 2026 trở đi.
Lập kế hoạch
`GenerateBenchmarksMetrics`	Tính năng mới	Thêm tính năng hỗ trợ cho bảng chi tiết theo ngày bằng cách sử dụng `BreakdownDefinition`.
`ReachPlanService.GenerateReachForecast`	Giá trị enum mới	Đã thêm `GOOGLE_DISPLAY_NETWORK` làm nền tảng có thể nhắm đến cho chiến dịch Tạo nhu cầu sử dụng chiến lược Tối đa hoá lượt chuyển đổi.
`GenerateTrendingInsights`	Trường mới	Đã thêm thông tin về đường xu hướng trong quá khứ từ `TrendInsightDataPoint` đến `TrendInsights` khi tìm kiếm theo chủ đề.
Báo cáo
Chỉ số về tần suất của người dùng riêng biệt	Trường mới	Thêm các chỉ số mới để báo cáo số lượng người dùng đã xem quảng cáo của bạn ít nhất 2, 3, 4, 5 hoặc 10 lần: `unique_users_two_plus`, `unique_users_three_plus`, `unique_users_four_plus`, `unique_users_five_plus` và `unique_users_ten_plus`.
`SearchTermMatchSource`	Giá trị enum mới	Đã thêm `VERTICAL_ADS_DATA_FEED` để hỗ trợ nguồn cấp dữ liệu quảng cáo ngành dọc, chẳng hạn như tính năng nhắm đến thực thể của Quảng cáo du lịch.
YouTubeVideoUpload
`YouTubeVideoUpload`	Dịch vụ / tài nguyên mới	Thêm dịch vụ `YouTubeVideoUpload` để hỗ trợ việc tải lên và quản lý video trên YouTube, cũng như thêm tài nguyên `YouTubeVideoUpload` để hỗ trợ việc tìm nạp trạng thái tải lên và siêu dữ liệu. Tính năng này chỉ được hỗ trợ cho REST và thư viện ứng dụng Python.

phiên bản 23 (28/1/2026)

Các tính năng mới, nội dung cập nhật và thay đổi có thể gây lỗi sau đây đã được thêm vào Google Ads API phiên bản 23 (một bản phát hành lớn).

Hãy xem phần Nâng cấp lên phiên bản mới nhất để được hướng dẫn.

Thay đổi có thể gây lỗi

Trạng thái ban đầu	Trạng thái mới	Loại thay đổi	Hướng dẫn triển khai
Quảng cáo
Được phép chia sẻ quảng cáo	`AdGroupAdError.AD_SHARING_NOT_ALLOWED`	Thay đổi về hành vi	Bạn không còn được phép chia sẻ quảng cáo giữa nhiều nhóm quảng cáo. Các yêu cầu cố gắng chia sẻ quảng cáo sẽ trả về lỗi `AD_SHARING_NOT_ALLOWED`.
Hỗ trợ `CallAd` và `CallAdInfo`	Không có	Xoá bỏ	Chúng tôi đã ngừng hỗ trợ quảng cáo tạo cuộc gọi. Hãy tham khảo bài viết Giới thiệu về quảng cáo tạo cuộc gọi trên trung tâm trợ giúp.
Chiến dịch
`Campaign.start_date` `Campaign.end_date`	`Campaign.start_date_time` `Campaign.end_date_time`	Đổi tên / thay thế	Sử dụng các trường ngày giờ mới để chỉ định thành phần thời gian cho chiến dịch. Các trường chỉ có ngày ban đầu sẽ bị xoá.
Tạo nhu cầu
`DemandGenMultiAssetAdInfo.lead_form_only`	Không có	Xoá bỏ	Đã xoá trường `lead_form_only`. Cập nhật các tham chiếu trong mã của bạn.
Báo cáo
Tổng hợp các chỉ số và giá trị nhận dạng nhãn hiệu suất của tài sản	Không có	Xoá bỏ	Xoá các chỉ số về nhãn hiệu suất tổng hợp của tài sản. Enum nhãn hiệu suất sẽ không còn được trả về cho Mạng Tìm kiếm và Mạng Hiển thị nữa.

Các tính năng và bản cập nhật (không làm gián đoạn)

Tính năng và thông tin cập nhật	Loại	Mô tả
Quảng cáo
`AdFormatType`	Giá trị enum mới	Thêm các loại định dạng mới: `TEXT`, `VERTICAL_ADS_BOOKING_LINK` và `VERTICAL_ADS_PROMOTION`.
Thành phần
`asset_group` lượt xem	Trường mới	Thêm các chỉ số sau: `metrics.engagements`, `metrics.engagement_rate` và `metrics.average_cpe`.
`asset_group_asset` lượt xem	Trường mới	Thêm các chỉ số sau: `metrics.average_cpe`, `metrics.average_cpm`, `metrics.trueview_average_cpv`, `metrics.video_trueview_view_rate`, `metrics.video_trueview_views` và `metrics.interaction_event_types`.
`Asset.orientation`	Trường mới	Đã thêm trường hướng chỉ đọc vào thành phần hình ảnh và video.
`CampaignAsset`	Tính năng mới	Đã thêm tính năng hỗ trợ để truy xuất các thành phần của chiến dịch khi `field_type` được đặt thành `HEADLINE` và `DESCRIPTION`.
`ServedAssetFieldType`	Giá trị enum mới	Đã thêm `HEADLINE_AS_SITELINK_POSITION_ONE`, `HEADLINE_AS_SITELINK_POSITION_TWO`, `DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_ONE` và `DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_TWO` cho các thành phần được phân phát dưới dạng đường liên kết của trang web.
`BusinessMessageAsset`	Tính năng / dịch vụ hỗ trợ mới	Thành phần tin nhắn cho doanh nghiệp đã cập nhật: Thêm tính năng hỗ trợ Facebook Messenger và Zalo làm nhà cung cấp. Thêm `FACEBOOK_MESSENGER` và `ZALO` vào `BusinessMessageProvider`. Đã thêm các trường `facebook_messenger_info` và `zalo_info`. Thêm `CUSTOMER_NOT_ON_ALLOWLIST_FOR_MESSAGE_ASSETS` vào `AssetError`.
Thanh toán
`InvoiceService.ListInvoices`	Các lựa chọn mới	Giờ đây, bạn có thể trả về thông tin chi tiết cụ thể hơn trong `Invoice`, bao gồm cả thông tin chi tiết về chi phí ở cấp chiến dịch, chi phí theo quy định được liệt kê và thông tin điều chỉnh, bằng cách đặt `include_granular_level_invoice_details` trong `ListInvoicesRequest`.
`RegulatoryFeeType` `UnitOfMeasure`	Enum mới	Đã thêm enum trợ giúp cho các loại phí theo quy định và đơn vị đo.
Chiến dịch
`CampaignError`	Giá trị enum / lỗi mới	Thêm mã lỗi `DURATION_TOO_LONG_FOR_TOTAL_BUDGET` và `END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET`.
Lượt chuyển đổi
ConversionActionCategory	Giá trị enum mới	Đã thêm `YOUTUBE_FOLLOW_ON_VIEWS` để hỗ trợ việc theo dõi những người dùng xem quảng cáo rồi sau đó xem video trên cùng một kênh.
Tạo nhu cầu
`DemandGenVideoResponsiveAdInfo.companion_banner`	Trường mới	Đã thêm chế độ hỗ trợ cho biểu ngữ đi kèm trong quảng cáo video thích ứng của chiến dịch Tạo nhu cầu.
Chương trình ưu đãi
Thêm tính năng hỗ trợ ưu đãi Chọn theo ý bạn (CYO): Thêm phương thức `FetchIncentive` để truy xuất các ưu đãi được cá nhân hoá hiện có cho người dùng. Thêm phương thức `ApplyIncentive` để áp dụng một ưu đãi đã chọn cho tài khoản khách hàng. Thêm tài nguyên `AppliedIncentive` (có thể truy vấn bằng `Search` và `SearchStream`) để cung cấp thông tin chi tiết về việc sử dụng. Thêm mã lỗi mới trong `IncentiveError` và `AuthenticationError.INVALID_EMAIL_ADDRESS`. Để tạo điều kiện thuận lợi cho việc xử lý lỗi theo chương trình chi tiết hơn, chúng tôi sẽ thêm các mã lỗi khác vào `IncentivesService` trong các bản phát hành trong tương lai. Bạn nên theo dõi các thông báo và ghi chú phát hành sắp tới về những mã lỗi mới này để đảm bảo ứng dụng của bạn có thể quản lý các chế độ lỗi mới này.
Lập kế hoạch
`AudienceInsightsDimension.LIFE_EVENT_USER_INTEREST`	Giá trị enum mới	Cho phép tạo đối tượng bằng cách sử dụng Sự kiện trong đời trên `GenerateAudienceCompositionInsights`, `GenerateSuggestedTargetingInsights`, `GenerateInsightsFinderReport` và `GenerateCreatorInsights`. Life Events không được hỗ trợ cho các phương thức `AudienceInsightsService` khác, chẳng hạn như `AudienceInsightsService.GenerateAudienceOverlap` và `AudienceInsightsService.GenerateTargetingSuggestionMetrics`.
`ReachPlanService.GenerateConversionRates`	Trường / lựa chọn mới	Giờ đây, phản hồi bao gồm các nền tảng để hỗ trợ đề xuất tỷ lệ chuyển đổi dựa trên các chế độ kiểm soát nền tảng (ví dụ: Gmail, Shorts). Chỉ được hỗ trợ cho chiến dịch Tạo nhu cầu.
`LanguageDistribution`	Trường / loại mới	Được thêm vào `YouTubeChannelInsights` để cung cấp thông tin chi tiết về việc phân phối ngôn ngữ trong nội dung của kênh YouTube.
`BenchmarksService`	Dịch vụ mới	So sánh dữ liệu quảng cáo trên YouTube với điểm chuẩn của ngành.
`AudienceInsightsService.GenerateAudienceDefinition`	Phương thức mới	Dịch nội dung mô tả bằng văn bản tự do về đối tượng mục tiêu thành các thuộc tính đối tượng phù hợp bằng AI tạo sinh.
`YouTubeChannelInsights.relevance_score`	Trường mới	Đánh giá mức độ phù hợp của một nhà sáng tạo đối với một chủ đề, có tính đến số lượt xem.
`TrendInsightMetrics.trend_change_percent`	Trường mới	Thể hiện mức thay đổi về tỷ lệ phần trăm trong giá trị của một xu hướng trong khoảng thời gian so sánh.
Đề xuất
`GenerateRecommendationsRequest`	Trường mới	Thêm `is_new_customer`. Khi được đặt thành `true` cho đề xuất `CAMPAIGN_BUDGET`, chế độ này sẽ sử dụng một mô hình được tối ưu hoá cho khách hàng mới (chỉ nên dùng cho những khách hàng không có chiến dịch).
Báo cáo
`AdGroupAdAssetView`	Hỗ trợ tính năng / chỉ số mới	Hiện hỗ trợ các chỉ số về lượt hiển thị, hiệu suất và lượt chuyển đổi cho `RESPONSIVE_DISPLAY_AD`.
Phân khúc `ad_sub_network_type`	Phân khúc mới	Cung cấp thông tin chi tiết về hiệu suất trong một mạng quảng cáo. Ban đầu, chỉ có sẵn cho chiến dịch Tạo nhu cầu trên YouTube (Trong luồng phát, Trong nguồn cấp dữ liệu, Shorts). Bạn phải chọn cùng với `ad_network_type`.
Báo cáo chiến dịch Tối đa hoá hiệu suất	Tính năng mới	Đã bật thông tin chi tiết về loại mạng quảng cáo cho chiến dịch Tối đa hoá hiệu suất.
`UserLocationView` `GeographicView`	Hỗ trợ phân khúc mới	Hỗ trợ các chỉ số được phân đoạn theo ngày chuyển đổi: `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` và `cross_device_conversions_value_by_conversion_date`.
Phân khúc quảng cáo theo ngành dọc	Phân khúc mới	Đã thêm các phân đoạn sau: `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` và `vertical_ads_vertical`.
`PerStoreView` `MatchedLocationInterestView`	Tài nguyên báo cáo mới	Đã thêm `PerStoreView` để truy vấn thông tin chi tiết về vị trí cửa hàng và `MatchedLocationInterestView` (cho chiến dịch Tối đa hoá AI) để cung cấp các chỉ số hiệu suất theo vị trí địa lý quan tâm.
Mua sắm
`ShoppingPerformanceView`	Hỗ trợ chỉ số mới	Hiện hỗ trợ các chỉ số sau đây được phân đoạn theo ngày chuyển đổi: `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`	Hỗ trợ chỉ số mới	Thêm tính năng hỗ trợ cho: `search_budget_lost_impression_share`, `search_rank_lost_impression_share`, `search_budget_lost_absolute_top_impression_share` và `search_rank_lost_absolute_top_impression_share`.
`ShoppingProduct.product_image_uri`	Trường mới	Đã thêm vào `ShoppingProduct`.
Quảng cáo dọc
`AdGroup.vertical_ads_format_setting`	Trường mới	Cho phép kiểm soát những định dạng quảng cáo có thể phân phát trong chiến dịch Tìm kiếm bằng nguồn cấp dữ liệu du lịch.
`AdGroupCriterion` `SharedCriterion`	Trường / tiêu chí mới	Đã thêm loại tiêu chí `vertical_ads_item_group_rule_list` vào `AdGroupCriterion` và `vertical_ads_item_group_rule` vào `SharedCriterion` để cho phép nhắm đến các nhóm mặt hàng trong chiến dịch Tìm kiếm bằng nguồn cấp dữ liệu du lịch.
Tích hợp nguồn cấp dữ liệu quảng cáo theo ngành dọc	Tính năng mới	Giờ đây, bạn có thể kết nối một nguồn cấp dữ liệu quảng cáo dọc với một chiến dịch tìm kiếm đang chạy bộ tính năng Tối đa hoá AI để hiển thị quảng cáo du lịch có đường liên kết đặt phòng và quảng cáo quảng bá tài sản cùng với quảng cáo dạng văn bản. Kiểm soát định dạng bằng `vertical_ads_format_setting` và xác định các quy tắc bằng `vertical_ads_item_group_rule`. Phân khúc báo cáo theo `AdFormatType` và phương diện nguồn cấp dữ liệu quảng cáo ngành dọc.
Video
`AdVideoAssetInfo.ad_video_asset_feature_control`	Trường mới	Đã thêm các lựa chọn kiểm soát tính năng cho thành phần quảng cáo dạng video.
`CampaignCriterionError`	Giá trị enum mới / lỗi	Thêm mã lỗi `INVALID_VIDEO_LINEUP_ID`.
Các chỉ số về khả năng nghe trên YouTube	Các chỉ số mới	Thêm các chỉ số về khả năng nghe cho quảng cáo dạng âm thanh trên YouTube, báo cáo xem quảng cáo có thể nghe được hay không và có thể đo lường khả năng nghe của bao nhiêu lượt hiển thị.

Phiên bản chính và phụ v22

API Google Ads phiên bản 22 có các tính năng mới, nội dung cập nhật và thay đổi mang tính đột phá sau đây.

Phiên bản 22.2 (24/6/2026)

Google Ads API phiên bản 22.2 có các tính năng mới và nội dung cập nhật sau đây. Các phiên bản phụ như v22.2 không chứa các thay đổi có thể gây lỗi.

Tính năng và thông tin cập nhật Loại Mô tả

Giải pháp chung

Tính năng và thông tin cập nhật	Loại	Mô tả
Giải pháp chung
`Asset.synthetic_content_info` `Ad.synthetic_content_info`	Trường mới	Chứa thông tin chứng thực cho nội dung giả tạo/do AI tạo, được chia thành `advertiser_attestation` (thông tin khai báo do nhà quảng cáo cung cấp trực tiếp) và `system_attestation` (thông tin chứng thực do hệ thống của Google tự động phát hiện hoặc cung cấp). Để giúp bạn lập kế hoạch cho công việc tích hợp sắp tới cho phiên bản 25, giao diện để thay đổi các trường chứng thực của nhà quảng cáo sẽ được ra mắt sớm cho phiên bản 22 trở lên. Giao diện này xuất hiện trong các phiên bản này, nhưng `synthetic_content_info.advertiser_attestation.status` và `synthetic_content_info.advertiser_attestation.source` sẽ không thay đổi đối với các phiên bản này. Nếu bạn cố gắng thực hiện một yêu cầu biến đổi trên một trong hai trường này, thì một trong các lỗi sau sẽ được trả về: "Trường mà bạn cố gắng thay đổi là trường không thể thay đổi" hoặc "Bạn không thể đặt trường". Các trường này sẽ hoàn toàn có thể thay đổi bắt đầu từ phiên bản 25. Bạn nên sử dụng giao diện này ngay bây giờ để tạo và kiểm thử logic nội bộ, nhờ đó hệ thống của bạn sẽ sẵn sàng cho các chức năng ghi đầy đủ khi phiên bản 25 ra mắt.
Phê duyệt nhiều bên	Tính năng mới	Giai đoạn thử nghiệm: Tính năng này hiện đang trong giai đoạn thử nghiệm và có thể thay đổi trong các bản phát hành sau này. Thêm tính năng hỗ trợ cho quy trình xem xét phê duyệt nhiều bên (MPA): Đã thêm tài nguyên `MultiPartyAuthReview` và `MultiPartyAuthReviewService` tương ứng. Thêm enum `MultiPartyAuthReviewStatus` để theo dõi trạng thái xem xét. Đã thêm `CustomerUserAccess.pending_multi_party_auth_review` để liên kết đến một bài đánh giá đang chờ xử lý. Đã thêm `MutateCustomerUserAccessResult.multi_party_auth_review` và `MutateCustomerUserAccessInvitationResult.multi_party_auth_review` để trả về tên tài nguyên bài đánh giá được liên kết. Đã thêm `MultiPartyAuthReviewError` cho các lỗi xác thực.

Asset.synthetic_content_info
Ad.synthetic_content_info

Trường mới

Nếu bạn cố gắng thực hiện một yêu cầu biến đổi trên một trong hai trường này, thì một trong các lỗi sau sẽ được trả về:

"Trường mà bạn cố gắng thay đổi là trường không thể thay đổi" hoặc "Bạn không thể đặt trường".

Phê duyệt nhiều bên

Tính năng mới

Thêm tính năng hỗ trợ cho quy trình xem xét phê duyệt nhiều bên (MPA):

Đã thêm tài nguyên MultiPartyAuthReview và MultiPartyAuthReviewService tương ứng.
Thêm enum MultiPartyAuthReviewStatus để theo dõi trạng thái xem xét.
Đã thêm CustomerUserAccess.pending_multi_party_auth_review để liên kết đến một bài đánh giá đang chờ xử lý.
Đã thêm MutateCustomerUserAccessResult.multi_party_auth_review và MutateCustomerUserAccessInvitationResult.multi_party_auth_review để trả về tên tài nguyên bài đánh giá được liên kết.
Đã thêm MultiPartyAuthReviewError cho các lỗi xác thực.

phiên bản 22.1 (25/2/2026)

API Google Ads phiên bản 22.1 có thêm tính năng mới sau đây. Các phiên bản nhỏ như v22.1 không chứa các thay đổi có thể gây lỗi.

Tính năng và thông tin cập nhật	Loại	Mô tả
Quản lý tài khoản
`Customer.contains_eu_political_advertising`	Trường mới	Truy xuất trạng thái khai báo ở cấp tài khoản về việc tài khoản có chứa quảng cáo chính trị nhắm đến Liên minh Châu Âu hay không, đồng thời trả về một `EuPoliticalAdvertisingStatus`.
Chiến dịch
`Campaign.missing_eu_political_advertising_declaration`	Trường mới	Hỗ trợ việc truy vấn và lọc những chiến dịch thiếu thông tin khai báo về việc có chứa quảng cáo chính trị nhắm đến Liên minh Châu Âu hay không.

phiên bản 22 (15/10/2025)

Các tính năng mới, nội dung cập nhật và thay đổi có thể gây lỗi sau đây đã được thêm vào Google Ads API phiên bản 22 (một bản phát hành chính).

Hãy xem phần Nâng cấp lên phiên bản mới nhất để được hướng dẫn.

Thay đổi có thể gây lỗi

Trạng thái ban đầu	Trạng thái mới	Loại thay đổi	Hướng dẫn triển khai
Tạo nhu cầu
`BudgetPerDayMinimumErrorDetails.minimum_bugdet_amount_micros`	`minimum_budget_amount_micros`	Đổi tên / sửa lỗi chính tả	Đổi tên các tham chiếu để sử dụng tên trường đã sửa.
Giải pháp chung
Không có giới hạn về số lượng thao tác trong `AddBatchJobOperations`	Giới hạn 10.000 thao tác cho mỗi yêu cầu	Thay đổi về hành vi	Đảm bảo rằng không có yêu cầu `AddBatchJobOperations` nào chứa quá 10.000 thao tác.
Kích thước trang bị giới hạn ngầm ở mức 1.000 trong `ListBatchJobResultsRequest`	Trả về lỗi `INVALID_PAGE_SIZE`	Thay đổi về hành vi	Đảm bảo `ListBatchJobResultsRequest.page_size` được đặt thành 1.000 hoặc ít hơn, vì việc yêu cầu kích thước trang lớn hơn hiện sẽ dẫn đến lỗi.
Tối đa hoá hiệu suất
Nhãn hiệu suất của tài sản	Không có	Xoá bỏ	Chúng tôi đã xoá chế độ hỗ trợ nhãn hiệu suất của thành phần và enum nhãn hiệu suất được liên kết cho chiến dịch Tối đa hoá hiệu suất. Cập nhật các chế độ tích hợp cho phù hợp.
`Campaign.url_expansion_opt_out`	`FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION` trong `AssetAutomationSetting`	Gỡ bỏ / thay thế	Sử dụng chế độ cài đặt tự động hoá thành phần văn bản cho tính năng mở rộng URL cuối cùng. Đã xoá trường chọn không sử dụng tính năng Mở rộng URL ở cấp chiến dịch.
Lập kế hoạch
`views`	`trueview_views`	Gỡ bỏ / thay thế	Thay thế các tham chiếu đến `views` bằng trường `trueview_views` mới trong `ReachPlanService`.
Video
`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`	Đổi tên	Cập nhật chuỗi truy vấn và hoạt động tích hợp để sử dụng tên chỉ số mới thể hiện số lượt xem video theo TrueView.

Các tính năng và bản cập nhật (không làm gián đoạn)

Tính năng và thông tin cập nhật	Loại	Mô tả
Thành phần
`AssetFieldType.LANDING_PAGE_PREVIEW`	Giá trị enum mới	Được thêm dưới dạng một loại trường thành phần hình ảnh mới.
`AssetGenerationService`	Dịch vụ mới (Thử nghiệm)	Cho phép tạo thành phần văn bản và hình ảnh bằng AI tạo sinh: `GenerateText`: Tạo văn bản dựa trên URL cuối cùng, câu lệnh, từ khoá, v.v. `GenerateImages`: Tạo hình ảnh dựa trên URL cuối cùng, câu lệnh hoặc hình ảnh sản phẩm được tái tạo bối cảnh. Các lỗi được trả về kèm theo mã từ `AssetGenerationError`. Ban đầu, tính năng này chỉ được cung cấp cho một số ít người tham gia giai đoạn thử nghiệm khép kín.
Chiến dịch
`AppCampaignBiddingStrategyGoalType`	Giá trị enum mới	Đã thêm mục tiêu mới cho chiến dịch Quảng cáo ứng dụng để tăng lượt cài đặt (ACi) nhằm tối ưu hoá mà không cần chỉ định mục tiêu: `OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA`: Sử dụng với chiến lược Tối đa hoá lượt chuyển đổi tiêu chuẩn. `OPTIMIZE_TOTAL_VALUE_WITHOUT_TARGET_ROAS`: Sử dụng với chiến lược Tối đa hoá giá trị lượt chuyển đổi tiêu chuẩn.
`BiddingStrategyType`	Tính năng mới	Đã thêm chế độ hỗ trợ cho loại chiến lược đặt giá thầu thị phần khoảng không quảng cáo cố định.
`Campaign.feed_types`	Trường mới	Cho biết các loại nguồn cấp dữ liệu được đính kèm vào một chiến dịch. Đối với chiến dịch Tối đa hoá hiệu suất, thông tin này có thể cho biết ngành dọc của doanh nghiệp, chẳng hạn như `MERCHANT_CENTER_FEED` cho ngành bán lẻ.
Nhắm mục tiêu theo nhóm chia sẻ	Tính năng mới	Cho phép đính kèm các bộ từ khoá phủ định được chia sẻ vào chiến dịch đa kênh (đối với chiến dịch Quảng cáo ứng dụng) và chiến dịch địa phương.
Tạo nhu cầu
Đặt giá thầu CPC mục tiêu	Tính năng mới	Đã thêm chiến lược đặt giá thầu để tối đa hoá số lượt nhấp ở CPC mục tiêu: đặt CPC mục tiêu ở cấp chiến dịch bằng cách sử dụng `Campaign.target_cpc` và ghi đè ở cấp nhóm quảng cáo bằng cách sử dụng `AdGroup.target_cpc_micros`.
`AssetAutomationType.GENERATE_DESIGN_VERSIONS_FOR_IMAGES`	Giá trị enum mới	Nếu được bật cho `DemandGenMultiAssetAdInfo`, tính năng này sẽ thêm các phần tử thiết kế và nhúng thành phần văn bản vào thành phần hình ảnh để tạo thành phần hình ảnh mới với các tỷ lệ khung hình khác nhau (được bật theo mặc định).
`AssetAutomationType.GENERATE_VIDEOS_FROM_OTHER_ASSETS`	Giá trị enum mới	Nếu được bật cho `DemandGenMultiAssetAdInfo`, tính năng này sẽ tạo video bằng các thành phần khác như hình ảnh và văn bản. Sau đó, bạn có thể dùng video này để tạo các thực thể `DemandGenVideoResponsiveAdInfo` mới (được bật theo mặc định).
Giải pháp chung
`ListBatchJobResultsRequest` kích thước trang dự phòng	Thay đổi về hành vi	Nếu bạn không đặt `page_size` hoặc đặt giá trị này là 0, thì giá trị mặc định hiện tại là tối đa 1.000 (trước đây trả về `INVALID_PAGE_SIZE`).
`QuotaError`	Giá trị enum mới / lỗi	Thêm `PAYMENTS_PROFILE_ACTIVATION_RATE_LIMIT_EXCEEDED` để cho biết thời điểm vượt quá hạn mức tỷ lệ kích hoạt hồ sơ thanh toán.
Tối đa hoá hiệu suất
Chế độ cài đặt tự động hoá thành phần	Giá trị enum mới	Thêm các lựa chọn mới về tính năng tự động hoá thành phần của chiến dịch Tối đa hoá hiệu suất: `GENERATE_IMAGE_ENHANCEMENT`: Bật tính năng tự động tạo hình ảnh nâng cao (tự động cắt). Bật theo mặc định. `GENERATE_IMAGE_EXTRACTION`: Hình ảnh lấy từ URL cuối cùng. Mặc định là chế độ cài đặt Phần mở rộng về hình ảnh linh hoạt của tài khoản.
Phân đoạn báo cáo của chiến dịch Tối đa hoá hiệu suất	Phân khúc mới	Đã thêm các phân khúc mới chỉ có trong chiến dịch Tối đa hoá hiệu suất: `ad_using_product_data`: Cho biết liệu quảng cáo có sử dụng dữ liệu sản phẩm của Google Merchant Center hay không. `ad_using_video`: Cho biết liệu quảng cáo có sử dụng thành phần video hay không.
Lập kế hoạch
Danh sách dữ liệu đối tác CRM	Tính năng / giá trị enum mới	Đã thêm `THIRD_PARTY_PARTNER_DATA` vào nguồn dữ liệu CRM, cùng với mã lỗi xác thực đối tượng của đối tác (chẳng hạn như chấp nhận điều khoản dịch vụ, thiếu đường liên kết, v.v.).
Chỉ số về nhà sáng tạo trong sự kiện phát trực tiếp	Trường mới	Đã thêm `YouTubeMetrics.is_active_live_stream_creator`, do thông tin chi tiết về nhà sáng tạo trả về để cho biết liệu nhà sáng tạo có phát trực tiếp trong 90 ngày qua hay không.
Siêu dữ liệu nguồn CRM có thể lập kế hoạch	Tin nhắn mới	Đã thêm `PlannableUserListMetadata` bên trong `PlannableUserList`, do `ReachPlanService.ListPlannableUserLists` trả về, để cho biết các loại nguồn dữ liệu CRM.
Hỗ trợ video và nhà sáng tạo có liên quan trong TrendInsight	Trường mới	Thêm tính năng hỗ trợ cho `related_videos` và `related_creators` trên `TrendInsight`, cũng như các thuộc tính theo dõi trong `video_properties` và `publish_date`.
Cải tiến InsightsFinder	Tính năng mới	`GenerateInsightsFinderReport` hiện hỗ trợ `parental_status`, `income_ranges` và các tổ hợp nhắm mục tiêu phức tạp hơn theo điều kiện VÀ/HOẶC.
Báo cáo
Loại lượt nhấp mới	Giá trị enum mới	Đã thêm `CLICK_TO_MESSAGE_THIRD_PARTY_CLICK` và `CLICK_TO_MESSAGE_LANDING_PAGE_CLICK`.
Phân khúc AssetGroupAsset	Hỗ trợ phân khúc mới	Giờ đây, bạn có thể phân đoạn `AssetGroupAsset` theo `device`, `conversion_action`, `conversion_action_name` và `conversion_action_category`.
RSA trong AdGroupAdAssetView	Hỗ trợ tính năng / chỉ số mới	`AdGroupAdAssetView` hiện hỗ trợ đầy đủ các chỉ số hiệu suất và lượt chuyển đổi cho `RESPONSIVE_SEARCH_AD` (trước đây, hệ thống chỉ trả về số lượt hiển thị).
Phân đoạn chỉ số cụm từ tìm kiếm khám phá	Hỗ trợ phân khúc mới	Giờ đây, bạn có thể phân đoạn các chỉ số `clicks_unique_query_clusters`, `conversions_unique_query_clusters` và `impressions_unique_query_clusters` theo các trường ngày.
TargetingExpansionView	Tài nguyên báo cáo mới	Đã thêm `TargetingExpansionView` vào các chỉ số báo cáo cho việc mở rộng phạm vi nhắm mục tiêu thủ công, chẳng hạn như tính năng mở rộng không dùng từ khoá cho bộ tính năng Tối đa hoá AI cho chiến dịch Tìm kiếm.
Mua sắm
Khắc phục phạm vi mua sắm	Sửa lỗi	Đã cố định phạm vi chiến dịch và nhóm quảng cáo của các chỉ số trong tài nguyên `ShoppingProduct`.
Mục tiêu hợp nhất
Mục tiêu giữ chân	Tính năng mới	Đã thêm chế độ hỗ trợ cho mục tiêu giữ chân khách hàng để tối ưu hoá việc thu hút lại khách hàng hiện tại (ví dụ: sử dụng `target_option` với `TARGET_SPECIFIC` hoặc `TARGET_ALL`).
Video
Chỉ số về thời gian xem video	Trường mới	Thêm chỉ số về thời lượng xem: `video_watch_time_duration_millis` (tổng thời lượng) và `average_video_watch_time_duration_millis` (thời lượng trung bình trên mỗi lượt hiển thị).

Phiên bản chính và phụ v21

Google Ads API phiên bản 21 có các tính năng mới, nội dung cập nhật và thay đổi có thể gây lỗi sau đây.

phiên bản 21.2 (24/6/2026)

Các tính năng mới và nội dung cập nhật sau đây đã được thêm vào Google Ads API phiên bản 21.2. Các phiên bản phụ như v21.2 không chứa các thay đổi có thể gây lỗi.

Tính năng và thông tin cập nhật	Loại	Mô tả
Giải pháp chung
Phê duyệt nhiều bên	Tính năng mới	Giai đoạn thử nghiệm: Tính năng này hiện đang trong giai đoạn thử nghiệm và có thể thay đổi trong các bản phát hành sau này. Thêm tính năng hỗ trợ cho quy trình xem xét phê duyệt nhiều bên (MPA): Đã thêm tài nguyên `MultiPartyAuthReview` và `MultiPartyAuthReviewService` tương ứng. Thêm enum `MultiPartyAuthReviewStatus` để theo dõi trạng thái xem xét. Đã thêm `CustomerUserAccess.pending_multi_party_auth_review` để liên kết đến một bài đánh giá đang chờ xử lý. Đã thêm `MutateCustomerUserAccessResult.multi_party_auth_review` và `MutateCustomerUserAccessInvitationResult.multi_party_auth_review` để trả về tên tài nguyên bài đánh giá được liên kết. Đã thêm `MultiPartyAuthReviewError` cho các lỗi xác thực.

phiên bản 21.1 (25/2/2026)

Google Ads API phiên bản 21.1 có các tính năng mới và nội dung cập nhật sau đây. Các phiên bản phụ như phiên bản 21.1 không chứa các thay đổi có thể gây lỗi.

Tính năng và thông tin cập nhật	Loại	Mô tả
Quản lý tài khoản
`Customer.contains_eu_political_advertising`	Trường mới	Truy xuất trạng thái khai báo ở cấp tài khoản về việc tài khoản có chứa quảng cáo chính trị nhắm đến Liên minh Châu Âu hay không, đồng thời trả về một `EuPoliticalAdvertisingStatusEnum`.
Chiến dịch
`Campaign.missing_eu_political_advertising_declaration`	Trường mới	Hỗ trợ việc truy vấn và lọc những chiến dịch thiếu thông tin khai báo về việc có chứa quảng cáo chính trị nhắm đến Liên minh Châu Âu hay không.

phiên bản 21 (06/08/2025)

Các tính năng mới, nội dung cập nhật và thay đổi có thể gây lỗi sau đây đã được thêm vào Google Ads API phiên bản 21 (một bản phát hành chính).

Hãy xem phần Nâng cấp lên phiên bản mới nhất để được hướng dẫn.

Thay đổi có thể gây lỗi

Trạng thái ban đầu	Trạng thái mới	Loại thay đổi	Hướng dẫn triển khai
Chiến dịch
Trả về `CriterionError.INVALID_LISTING_GROUP_HIERARCHY`	Trả lại `CriterionError.LISTING_GROUP_ERROR_IN_ANOTHER_OPERATION`	Thay đổi mã lỗi	Đối với các yêu cầu có bật tính năng thất bại một phần, hãy xử lý mã lỗi mới thay vì mã lỗi phân cấp ban đầu.
Lượt chuyển đổi
Quyền truy cập vào chế độ `debug_enabled` trong `ConversionUploadService`	Không có	Xoá bỏ	Trường `debug_enabled` sẽ bị xoá. Cập nhật mã tham chiếu đến mã đó để không đặt hoặc truy vấn tham số này.
Những thay đổi đối với quảng cáo chính trị ở Liên minh Châu Âu
Nội dung tự khai báo chiến dịch không bắt buộc đối với quảng cáo chính trị ở Liên minh Châu Âu	Trường bắt buộc `contains_eu_political_advertising` đối với chiến dịch mới	Quy tắc xác thực / sự thay đổi về hành vi	Các lệnh gọi API để tạo chiến dịch mới sẽ không thành công kèm theo lỗi `FieldError.REQUIRED` nếu bạn không đặt trường này. Kể từ ngày 22 tháng 9 năm 2025, những chiến dịch được khai báo là `CONTAINS_EU_POLITICAL_ADVERTISING` sẽ không còn phân phát ở Liên minh Châu Âu nữa.
Tiêu chí có thể sửa đổi mà không cần tự khai báo	Không cập nhật được `CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION`	Quy tắc xác thực / sự thay đổi về hành vi	Đặt trạng thái tự khai báo trước khi cố gắng tạo hoặc cập nhật tiêu chí nhắm mục tiêu theo khoảng cách, vị trí hoặc nhóm vị trí ở cấp chiến dịch hoặc nhóm quảng cáo cho các chiến dịch hiện có.
Thử nghiệm không có yêu cầu tự khai báo	Không cập nhật được `ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION`	Quy tắc xác thực / sự thay đổi về hành vi	Đảm bảo rằng bạn đã hoàn tất việc tự khai báo trên các chiến dịch của thử nghiệm.
Tối đa hoá hiệu suất
`brand_guidelines_enabled` mặc định là `false`	Mặc định là `true`.	Thay đổi về hành vi	Đối với chiến dịch Tối đa hoá hiệu suất mới, nguyên tắc trình bày thương hiệu được bật theo mặc định. Đặt trường này thành `false` một cách rõ ràng nếu bạn muốn vô hiệu hoá các trường đó.
Lập kế hoạch
Loại đối số đầu vào ban đầu cho `AudienceInsightsService.GenerateTargetingSuggestionMetrics`	Đầu vào thuộc loại `InsightsAudience`	Thay đổi loại	Cập nhật việc triển khai để truyền loại đầu vào mới hỗ trợ tổ hợp AND-of-ORs về mối quan tâm của người dùng, cho phép các chỉ số phạm vi tiếp cận tiềm năng cho định nghĩa đối tượng tuỳ chỉnh.

Các tính năng và bản cập nhật (không làm gián đoạn)

Tính năng và thông tin cập nhật	Loại	Mô tả
Tối đa hoá AI cho chiến dịch Tìm kiếm
`ai_max_setting.enable_ai_max` trong `Campaign`	Trường mới	Cho phép bộ tính năng Tối đa hoá AI mở rộng tính năng so khớp cụm từ tìm kiếm (vẫn sử dụng tính năng tự động hoá thành phần văn bản và danh sách thương hiệu trước đây cho đến khi bạn tắt). Trường `Campaign.ai_max_setting.bundling_required` cho biết bạn phải bật bộ tính năng Tối đa hoá AI để tuân thủ/sửa đổi các chế độ cài đặt đó và `AdGroup.ai_max_ad_group_setting.disable_search_term_matching` có thể tắt tính năng so khớp ở cấp nhóm quảng cáo. Xem bài viết Nâng cao hiệu suất với bộ tính năng Tối đa hoá AI cho chiến dịch Tìm kiếm.
`CampaignError.AI_MAX_MUST_BE_ENABLED`	Giá trị enum mới / lỗi	Được gửi khi chọn sử dụng tính năng tự động hoá thành phần văn bản mở rộng URL trong chiến dịch Tìm kiếm mà không bật bộ tính năng Tối đa hoá AI.
Tiêu chí nhắm mục tiêu ở cấp nhóm quảng cáo	Tính năng mới	Đã thêm chế độ hỗ trợ cho bộ tính năng Tối đa hoá AI cho chiến dịch Tìm kiếm đối với danh sách thương hiệu, vị trí và trang web (quy tắc về URL) ở cấp nhóm quảng cáo.
`ai_max_search_term_ad_combination_view`	Tài nguyên báo cáo mới	Báo cáo hiệu suất của các tổ hợp cụm từ tìm kiếm, dòng tiêu đề và trang đích.
Phân khúc `search_term_match_type`	Giá trị enum mới	Thêm `AI_MAX` làm lựa chọn kiểu khớp cho cụm từ tìm kiếm.
Thành phần
`PromotionAsset`	Trường mới	Đã thêm `terms_and_conditions_text`, `terms_and_conditions_uri` và một trong các lựa chọn `promotion_trigger` (`promotion_barcode_info`, `promotion_qr_code_info`). Xem phần Giới thiệu về thành phần chương trình khuyến mãi.
`AssetAutomationType.FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION`	Giá trị enum mới	Được thêm vào `AssetAutomationType` để kiểm soát văn bản tự động và việc tạo trang đích từ URL cuối cùng trong chiến dịch Tìm kiếm.
`AutomaticallyCreatedAssetRemovalService.RemoveCampaignAutomaticallyCreatedAsset`	Dịch vụ / phương thức mới	Cho phép xoá thành phần được tạo tự động của tính năng mở rộng URL cuối cùng khỏi chiến dịch.
`ServedAssetFieldType.DESCRIPTION_PREFIX`	Giá trị enum mới	Đã thêm để khắc phục một vấn đề về báo cáo trong đó loại được trả về là `UNKNOWN` trong `ad_group_ad_asset_combination_view`.
Chiến dịch
`CampaignPrimaryStatusReason.MISSING_LOCATION_TARGETING`	Giá trị enum mới	Trả về khi chiến dịch bị hạn chế theo vị trí không có tiêu chí nhắm mục tiêu theo vị trí (giờ đây, tiêu chí này sẽ gửi `LOCATION_TARGETING_NOT_ELIGIBLE_FOR_RESTRICTED_CAMPAIGN` nếu được nhắm đến bên ngoài khu vực được phép).
Tích hợp số liệu phân tích ứng dụng của bên thứ ba	Trường mới	Thêm tính năng hỗ trợ cho `VideoCustomer.third_party_integration_partners` và `Campaign.third_party_integration_partners`. Xem bài viết Theo dõi lượt chuyển đổi đối với ứng dụng bằng dịch vụ phân tích ứng dụng bên thứ ba.
`Campaign.advertising_partner_ids`	Hỗ trợ trường mới	Giờ đây, bạn có thể đặt trường này cho các chiến dịch hiện có (vẫn không thay đổi sau khi được đặt).
Vị trí phủ định ở cấp người quản lý	Tính năng mới	Cho phép loại trừ danh sách vị trí trên các tài khoản nhà quảng cáo riêng lẻ bằng cách sử dụng `CustomerNegativeCriterion`.
Cấu hình mức độ chấp nhận trong chiến lược ROAS mục tiêu	Trường mới	Thêm tính năng hỗ trợ cho `TargetRoas.target_roas_tolerance_percent_millis` (đối với chiến lược danh mục đầu tư của chiến dịch Tìm kiếm) trong `MaximizeConversionValue` và `TargetRoas`.
`LocationInterestView`	Tài nguyên báo cáo mới	Tóm tắt hiệu suất của tiêu chí vị trí quan tâm của nhóm quảng cáo.
Lượt chuyển đổi
Phân khúc `conversion_attribution_event_type`	Giá trị enum mới	Đã thêm `ENGAGED_VIEW` vào các lựa chọn về loại mô hình phân bổ lượt chuyển đổi.
Tạo nhu cầu
`CampaignBudgetError.BUDGET_BELOW_DAILY_MINIMUM`	Giá trị enum mới / lỗi	Được thêm vào để chuẩn bị cho việc thực thi ngân sách hằng ngày tối thiểu cho chiến dịch Tạo nhu cầu. Thông tin chi tiết được hiển thị bằng `budgetDailyMinimumErrorDetails`.
Tối đa hoá hiệu suất
`campaign_search_term_view`	Tài nguyên báo cáo mới	Tổng hợp các chỉ số về cụm từ tìm kiếm ở cấp chiến dịch, cho phép phân tích và báo cáo cụm từ tìm kiếm cho chiến dịch Tối đa hoá hiệu suất.
Lập kế hoạch
`ReachPlanService.ListPlannableUserInterests`	Phương thức mới	Cho phép khám phá các đối tượng chung sở thích và mối quan tâm có ý định mua hàng có thể lập kế hoạch cho `generateReachForecast`.
`AdditionalApplicationInfo`	Trường mới	Được thêm dưới dạng một dữ liệu đầu vào không bắt buộc trong `ReachPlanService.ListPlannableUserLists`.
Danh sách thuộc tính AudienceInsights	Tính năng mới	`AudienceInsightsService.ListAudienceInsightsAttributes` hiện tìm nạp danh sách người dùng bên thứ nhất có sẵn.
Nhắm mục tiêu theo danh sách CRM AudienceCompositionInsights	Tính năng mới	`AudienceInsightsService.GenerateAudienceCompositionInsights` hiện trả về thông tin chi tiết về chỉ mục danh sách người dùng cho các phương diện `AudienceInsightsDimension`: `AGE_RANGE`, `GENDER`, `AFFINITY_USER_INTEREST` và `IN_MARKET_USER_INTEREST`.
`TrendInsightMetrics` tỷ lệ người xem	Trường mới	Biểu thị tỷ lệ khán giả của một xu hướng.
`KnowledgeGraphAttributeMetadata` danh mục	Trường mới	Lọc các thuộc tính trong Sơ đồ tri thức theo danh mục phù hợp.
Báo cáo
Chỉ số về lượt xem thành phần	Tính năng / chỉ số mới	Thêm nhiều chỉ số mới vào `AssetGroupAsset`, `ChannelAggregateAssetView` và `CampaignAggregateAssetView`. Giờ đây, chiến dịch Tối đa hoá hiệu suất cũng báo cáo giá trị thực cho `impressions`.
Tiện ích bộ chọn	Tính năng mới	Đã tạo `AssetSet` và `CampaignAssetSet` có thể truy vấn cùng nhau trong `ChangeStatus`.
`search_term_targeting_status`	Phân khúc mới	Phân khúc có thể chọn trong chế độ xem cụm từ tìm kiếm của chiến dịch.
`final_url_expansion_asset_view`	Tài nguyên báo cáo mới	Báo cáo thông tin chi tiết về hiệu suất của thành phần mở rộng URL cuối cùng.
Mức điều chỉnh giá trị AssetGroup	Trường mới	Thêm tính năng hỗ trợ cho các chỉ số `value_adjustment` và `all_value_adjustment` trong báo cáo `AssetGroup`.
`landing_page_source`	Phân khúc mới	Cung cấp một phân đoạn nguồn trang đích trong `landing_page_view`.
`search_term_match_source`	Phân khúc mới	Phân khúc có thể chọn trong cụm từ tìm kiếm và chế độ xem cụm từ tìm kiếm của chiến dịch.
`match_type`	Phân khúc mới	Khoá phân đoạn có thể chọn trong chế độ xem từ khoá.
Báo cáo về nhóm ý định tìm kiếm riêng biệt	Trường mới	Đã thêm `clicks_unique_query_clusters`, `conversions_unique_query_clusters` và `impressions_unique_query_clusters` để báo cáo các cụm ý định tìm kiếm riêng biệt.
`ClickType.VEHICLE_ASSETS`	Giá trị enum mới	Theo dõi và báo cáo số lượt nhấp liên quan cụ thể đến định dạng quảng cáo xe trong báo cáo `click_view`.
Khám phá cơ hội đặt giá thầu thông minh
cấu hình dung sai trong chiến lược Tìm kiếm	Trường / chế độ cài đặt mới	Cho phép bật tính năng Khám phá chiến lược đặt giá thầu thông minh trên chiến dịch Tìm kiếm bằng cách đặt `target_roas_tolerance_percent_millis` trong khoảng từ 10.000 (10%) đến 30.000 (30%) (bao gồm cả hai giá trị này) (chiến lược Tối đa hoá lượt chuyển đổi yêu cầu bạn đặt `target_roas`). Hãy xem bài đăng trên blog của chúng tôi về tính năng Khám phá chiến lược đặt giá thầu thông minh và bài viết trên trung tâm trợ giúp.
khả năng tương thích của báo cáo về tính đa dạng	Tính năng mới	Hiện tại, chúng tôi hỗ trợ báo cáo tổng hợp về mức độ đa dạng cho các chỉ số sau đây đối với các cụm ý định tìm kiếm riêng biệt. Bạn có thể xem theo phân đoạn thời gian trong giao diện người dùng Google Ads: `clicks_unique_query_clusters` `conversions_unique_query_clusters` `impressions_unique_query_clusters`
Video
`YouTubeVideoListAsset`	Tài nguyên / trường mới	Cho phép thiết lập mối liên kết giữa chiến dịch và thành phần danh sách video bằng cách sử dụng `Asset.youtube_video_list_asset`. Xem phần Sử dụng video có liên quan.
Tiện ích siêu dữ liệu thông tin chi tiết	Trường mới	Đã thêm siêu dữ liệu mới vào `YouTubeChannelInsights` và `YouTubeVideoAttributeMetadata`.
Loại lượt nhấp tương tác	Giá trị enum mới	Đã thêm các loại lượt nhấp: `VIDEO_RELATED_VIDEOS_CLICK`, `VIDEO_CHANNEL_CLICK` và `PRODUCT_ASSETS`.
`VideoAdInventoryControl.allow_non_skippable_in_stream`	Trường mới	Cho phép quảng cáo dạng video thích ứng phân phát dưới dạng quảng cáo trong luồng phát không thể bỏ qua cho những chiến dịch kết hợp định dạng có thể bỏ qua và không thể bỏ qua.
Chế độ cài đặt trình tự video	Trường mới	Đã thêm các cấu hình sắp xếp chỉ có thể đọc: `Campaign.VideoCampaignSettings.video_ad_sequence` và `VideoAdSequenceStepSetting`. Xem bài viết Giới thiệu về tính năng sắp xếp quảng cáo dạng video theo trình tự.
Nhắm mục tiêu theo nhóm kênh nổi tiếng	Loại tiêu chí / trường mới	Đã thêm loại tiêu chí `VIDEO_LINEUP` và trường tương ứng trong `CampaignCriterion` và `AdGroupCriterion`. Tính năng này chỉ dành cho những tài khoản có trong danh sách cho phép.
Số lượt xem vị trí theo mức độ phù hợp của nội dung	Tài nguyên báo cáo mới	Thêm báo cáo Mức độ phù hợp của nội dung cho cả cấp độ chi tiết (`detail_content_suitability_placement_view`) và cấp độ nhóm (`group_content_suitability_placement_view`). Xem bài viết Giới thiệu về báo cáo "Mức độ phù hợp của nội dung".