Hãy tham khảo phần Ngừng sử dụng tính năng để biết danh sách mới nhất về các tính năng hiện tại và dự kiến ngừng sử dụng.
Phiên bản lớn v26
Google Ads API phiên bản 26 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 26 (14/10/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 26 (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ường country_code không bắt buộc trong LocalServicesPmaxCampaignSettings |
Trường bắt buộc trong quá trình tạo chiến dịch Tối đa hoá hiệu suất cho dịch vụ tại địa phương (LocalServicesPmaxCampaignSettings.country_code) |
Sự thay đổi hành vi | Hãy nhớ chỉ định country_code (cùng với listing_id mới bắt buộc) khi tạo chiến dịch Tối đa hoá hiệu suất cho Dịch vụ địa phương. |
| Lượt chuyển đổi | |||
Trường enhanced_conversions_for_leads_enabled trong ConversionTrackingSetting (Customer.conversion_tracking_setting) |
Không có | Xoá | Hãy sử dụng ConversionTrackingSetting.enablement_setting trên Customer.conversion_tracking_setting để kiểm tra chế độ cài đặt Lượt chuyển đổi nâng cao ở cấp tài khoản. |
| Nhắm mục tiêu | |||
Các trường tiêu chí dành riêng cho khách sạn trong AdGroupBidModifier:
|
Các trường tiêu chí không phụ thuộc vào ngành dọc trong AdGroupBidModifier:
|
Đổi tên / xoá | Cập nhật tệp đối chiếu để sử dụng các trường tiêu chí không phụ thuộc vào ngành dọc, hỗ trợ nhắm mục tiêu trên các ngành dọc du lịch ngoài khách sạn (chẳng hạn như Điểm tham quan). Mã tiêu chí, hành vi nhắm mục tiêu và hệ số điều chỉnh giá thầu hiện có vẫn giữ nguyên. Các giá trị cho min_nights và max_nights được chuyển sang min_days và max_days như hiện tại. |
HotelDateSelectionType và loại segments.user_set_dates |
DateSelectionType |
Đổi tên / thay đổi loại | Sử dụng DateSelectionType thay vì HotelDateSelectionType. |
Lý do lỗi dành riêng cho khách sạn trong CriterionError:
|
Lý do gây ra lỗi không phụ thuộc vào ngành dọc trong CriterionError:
|
Đổi tên | Cập nhật cách xử lý lỗi để kiểm tra các lý do gây ra lỗi mới không phụ thuộc vào ngành dọ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ả |
|---|---|---|
| Thành phần | ||
| Nhà cung cấp dịch vụ nhắn tin cho doanh nghiệp qua LINE và SMS | Các trường và giá trị enum mới | Thêm tính năng hỗ trợ cho LINE và SMS làm nhà cung cấp dịch vụ nhắn tin trong BusinessMessageAsset, bao gồm cả các trường mới BusinessMessageAsset.line_info và BusinessMessageAsset.sms_info cùng với BusinessMessageProvider.LINE và BusinessMessageProvider.SMS. |
AssetGroupError.UNSUPPORTED_LOCAL_SERVICES_CATEGORY |
Giá trị enum / lỗi mới | Đã thêm vào AssetGroupError để cho biết thời điểm một danh mục được chỉ định trong GoogleLocalServicesInfo (AssetGroup.google_local_services_info) không được hỗ trợ cho chiến dịch Tối đa hoá hiệu suất cho Dịch vụ địa phương. |
| Chiến dịch | ||
| Tạo chiến dịch Tối đa hoá hiệu suất cho Dịch vụ địa phương | Các tính năng, trường và lỗi mới |
Cập nhật Ngoài ra, chúng tôi đã thêm |
| Lỗi xác thực chiến dịch Dịch vụ địa phương | Giá trị enum và lỗi mới | Đã thêm lỗi xác thực mới cho chiến dịch Dịch vụ địa phương: |
| Xác thực mối liên kết tài khoản Hotel Center | Giá trị enum / lỗi mới | Đã thêm mã lỗi CampaignError.HOTEL_PROPERTY_ASSET_SET_HOTEL_CENTER_LINK_REQUIRED vào CampaignError để cho biết rằng việc liên kết một bộ thành phần cơ sở lưu trú khách sạn (Campaign.hotel_property_asset_set) với chiến dịch Tối đa hoá hiệu suất cho mục tiêu về du lịch yêu cầu phải có mối liên kết đang hoạt động với tài khoản Hotel Center. |
| Ngân sách tối thiểu mỗi ngày cho chiến dịch Tạo nhu cầu | Trường mới | Thêm trường demand_gen_info.minimum_budget_per_day_micros vào CurrencyConstant để chỉ định ngân sách tối thiểu bắt buộc mỗi ngày cho chiến dịch Tạo nhu cầu bằng đơn vị tiền tệ đó. Giá trị của trường này sẽ cập nhật khi ngân sách tối thiểu do API thực thi thay đổi. |
| Cấu hình đo lường mức tăng cho chiến dịch | Trường mới | Thêm Campaign.lift_measurement_config để hiển thị tên tài nguyên của cấu hình đo lường mức tăng được liên kết với chiến dịch. |
| Xác thực thử nghiệm Tối đa hoá AI | Giá trị enum / lỗi mới | Đã thêm mã lỗi ExperimentArmError.ADOPT_AI_MAX_CAMPAIGN_ALREADY_ENABLED vào ExperimentArmError khi cố gắng tạo thử nghiệm ADOPT_AI_MAX cho một chiến dịch đã bật bộ tính năng Tối đa hoá AI (hoặc được bật trong cùng một yêu cầu trước khi tạo nhóm thử nghiệm). |
| Loại trang thông tin của chiến dịch Mua sắm | Dịch vụ hỗ trợ mở rộng | Mở rộng phạm vi hỗ trợ của Campaign.listing_type cho chiến dịch Mua sắm. |
| Thông tin cập nhật về nội dung tự khai báo quảng cáo chính trị ở Liên minh Châu Âu | Hành vi được cập nhật và các trường mới |
|
| Lượt chuyển đổi | ||
| Cấu hình hợp nhất cho tính năng Lượt chuyển đổi nâng cao | Trường và enum mới | Đã thêm ConversionTrackingSetting.enablement_setting và ConversionTrackingSetting.effective_enablement_setting (trên Customer.conversion_tracking_setting) để hiển thị cấu hình hợp nhất của tính năng Lượt chuyển đổi nâng cao cho tài khoản, được biểu thị bằng enum EnhancedConversionsConfig mới. |
ConversionActionCategory.MESSAGE_LEAD |
Giá trị enum mới | Đã thêm vào ConversionActionCategory để hỗ trợ các lượt tương tác qua tin nhắn hoặc cuộc trò chuyện cho thấy sự quan tâm đến sản phẩm/dịch vụ của nhà quảng cáo. |
ConversionAttributionEventType.CLICK |
Giá trị enum mới | Được thêm vào ConversionAttributionEventType để biểu thị những lượt chuyển đổi được phân bổ cho một lượt nhấp vào quảng cáo, trước đây được đưa vào giá trị enum UNKNOWN. |
| Giải pháp chung | ||
| Thông tin cập nhật về khách hàng tiềm năng từ Dịch vụ địa phương | Trường và giá trị enum mới |
|
| Đề xuất | ||
| Đề xuất tăng ngân sách cho chiến dịch Tìm kiếm | Đề xuất mới | Thêm RecommendationType.RAISE_BUDGET_PERFORMANCE_TOO_LOW, Recommendation.raise_budget_performance_too_low_recommendation và ApplyRecommendationOperation.raise_budget_performance_too_low để hỗ trợ tăng ngân sách khi ngân sách hằng ngày quá thấp cho chiến dịch Tìm kiếm. |
| Báo cáo | ||
| Đo lường mức tăng lưu lượng tìm kiếm | Các tính năng, tài nguyên, phân đoạn và chỉ số mới | Thêm tính năng hỗ trợ cho các phép đo lường Mức tăng lưu lượng tìm kiếm:
|
| Chế độ xem thành phần mở rộng URL cuối cùng cho chiến dịch Mua sắm | Hỗ trợ mở rộng | Mở rộng final_url_expansion_asset_view để hỗ trợ chiến dịch Mua sắm (với ad_group có thể chọn làm tài nguyên được phân bổ cùng với final_url_expansion_asset_view.ad_group). |
| Video | ||
| Thông tin công bố về nội dung do AI tạo trên YouTube | Các trường và enum mới | Thêm tính năng hỗ trợ thông tin công bố về nội dung tạo sinh cho video tải lên YouTube. Trường mới YouTubeVideoUpload.video_content_metadata thuộc loại VideoContentMetadata đã được thêm vào YouTubeVideoUpload, chứa các chế độ cài đặt thông tin công bố trong VideoContentMetadata.generative_content_disclosure thuộc loại YouTubeVideoUploadGenerativeContentDisclosure. |
phiên bản lớn và phiên bản nhỏ v25
Google Ads API phiên bản 25 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.
v25.2 (23/9/2026)
Các tính năng và nội dung cập nhật mới sau đây đã được thêm vào Google Ads API phiên bản 25.2. Các phiên bản nhỏ như phiên bản 25.2 không chứa 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 | ||
Các lựa chọn về URL cho AssetGroup |
Trường mới | Bổ sung tính năng hỗ trợ cho các lựa chọn URL trên AssetGroup, cho phép nhà quảng cáo chỉ định mẫu theo dõi, tham số tuỳ chỉnh và hậu tố URL cuối cùng ở cấp nhóm thành phần:
|
| Chiến dịch | ||
| Thông tin về lượt thu thập dữ liệu video tự động | Các trường và enum mới | Đã thêm AutomatedVideoCrawlSetting vào Campaign.AssetAutomationSetting, cùng với AssetAutomationType.AUTOMATED_VIDEO_CRAWL, cho phép bạn chỉ định chế độ cài đặt thu thập thông tin video tự động cho chiến dịch Tối đa hoá hiệu suất. AutomatedVideoCrawlSetting.automated_video_crawl_infos chứa danh sách các mục AutomatedVideoCrawlInfo, mỗi mục định cấu hình một url thu thập dữ liệu, source_platform (VideoCrawlSourcePlatform: LANDING_PAGE, SOCIAL hoặc YOUTUBE) và trạng thái chọn sử dụng enabled. |
| Lỗi hệ số nhân tối ưu hoá vòng đời của khách hàng | Giá trị enum và lỗi mới | Thêm lý do mới gây ra lỗi xác thực khi định cấu hình hệ số nhân giá trị (value_multiplier và high_lifetime_value_multiplier) cho tính năng Tối ưu hoá vòng đời khách hàng:
|
SmartCampaignSettingService.GeneratePMaxDraftCampaign |
Tính năng mới | Đã thêm SmartCampaignSettingService.GeneratePMaxDraftCampaign để hỗ trợ việc tạo chiến dịch Tối đa hoá hiệu suất ở trạng thái nháp từ một chiến dịch Thông minh hiện có, được khởi tạo với trạng thái CampaignStatus.PAUSED và trạng thái tạo là CampaignCreationStatus.INCOMPLETE (xem Chuyển đổi chiến dịch thông minh thành chiến dịch Tối đa hoá hiệu suất):
|
| Lượt chuyển đổi | ||
| Lượt hiển thị quảng cáo trên Firebase | Danh mục và loại hành động chuyển đổi mới | Hiển thị các loại hành động chuyển đổi FIREBASE_ANDROID_APP_AD_IMPRESSION và FIREBASE_IOS_APP_AD_IMPRESSION, cho phép bạn truy xuất và sửa đổi các hành động chuyển đổi này. Đồng thời, hiển thị danh mục IN_APP_AD_REVENUE trong ConversionActionCategory để theo dõi doanh thu kiếm tiền từ quảng cáo trong ứng dụng. |
| Giải pháp chung | ||
BusinessProfileLocationSyncError |
Enum và lỗi mới | Đã thêm lý do gây ra lỗi đồng bộ hoá địa điểm trên Trang doanh nghiệp khi đồng bộ hoá địa điểm trong một AssetSet thuộc loại LOCATION_SYNC. Thay vì trả về lỗi UNKNOWN chung chung, API hiện trả về BusinessProfileLocationSyncError kèm theo lý do cụ thể (EMAIL_INVALID, OAUTH_TOKEN_INVALID, ACCOUNT_REMOVED và NO_PERMISSION_TO_ACCESS_LOCATION_ACCOUNT). |
| Lập kế hoạch | ||
Chỉ số phân vị BenchmarksService.GenerateBenchmarksMetrics |
Tính năng mới |
Cập nhật
Bổ sung tính năng hỗ trợ cho các chỉ số phân vị đối với ngày trong quý đang mở trong Thêm một lỗi |
| Tên người dùng của kênh YouTube để xem thông tin chi tiết về nhà sáng tạo | Tính năng mới | Cập nhật ContentCreatorInsightsService.GenerateCreatorInsights để hỗ trợ tìm kiếm theo tên người dùng của kênh YouTube bằng YouTubeChannels.youtube_channel_handles (tên người dùng hợp lệ của kênh phải bắt đầu bằng @, chẳng hạn như @channel_handle). Lựa chọn này tương tự như việc tìm kiếm theo mã nhận dạng kênh YouTube. Phản hồi này chứa thông tin chi tiết về những nhà sáng tạo được yêu cầu trên YouTube. |
| Đề xuất | ||
| Đề xuất về giá thầu CPA và ROAS | Đề xuất mới | Đã thêm Recommendation.raise_target_cpa_performance_bid_too_low_recommendation (RAISE_TARGET_CPA_PERFORMANCE_BID_TOO_LOW) và Recommendation.lower_target_roas_performance_bid_too_low_recommendation (LOWER_TARGET_ROAS_PERFORMANCE_BID_TOO_LOW), cùng với ApplyRecommendationOperation.raise_target_cpa_performance_bid_too_low và ApplyRecommendationOperation.lower_target_roas_performance_bid_too_low, để hỗ trợ việc tăng CPA mục tiêu hoặc giảm ROAS mục tiêu khi giá thầu quá thấp để chiến dịch Tìm kiếm có thể tham gia phiên đấu giá:
|
| Báo cáo | ||
| Phân đoạn phương diện hành trình khách sạn | Phân khúc mới | Đã thêm các phân khúc phương diện sau đây về hành trình đặt phòng khách sạn và du lịch vào Segments (có thể chọn bằng campaign, ad_group và customer):
|
| Chỉ số quảng cáo theo ngành dọc | Các chỉ số mới | Đã thêm các chỉ số sau đây cho báo cáo quảng cáo dọc về khách sạn và du lịch vào Metrics (có thể chọn bằng campaign, ad_group và customer):
|
| 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 khúc sau đây cho báo cáo quảng cáo dọc về khách sạn và du lịch vào Segments (có thể chọn bằng campaign, ad_group và customer):
|
Phiên bản 25.1 (19/8/2026)
Các tính năng và nội dung cập nhật mới sau đây đã được thêm vào Google Ads API phiên bản 25.1. Các phiên bản nhỏ như phiên bản 25.1 không chứa 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 | ||
AssetFieldType.TEXT_DISCLAIMER ServedAssetFieldType.TEXT_DISCLAIMER |
Giá trị enum mới | Bổ sung tính năng hỗ trợ cho thành phần tuyên bố từ chối trách nhiệm bằng văn bản. |
| Chiến dịch | ||
Campaign.aca_migration_date_time Campaign.broad_match_migration_date_time |
Trường mới | Theo dõi quá trình tự động di chuyển sắp tới sang bộ tính năng Tối đa hoá AI. |
| Lượt chuyển đổi | ||
| Phép đo lường Mức tăng thương hiệu | Tính năng mới | Thêm tính năng hỗ trợ đo lường Mức tăng thương hiệu bằng các nội dung cập nhật sau:
|
| Kết quả đo lường Mức tăng lượt chuyển đổi | Tính năng mới | Đã thêm chế độ hỗ trợ cho giải pháp đo lường Mức tăng lượt chuyển đổi bằng các nội dung cập nhật sau:
|
LiftMeasurementFlight |
Tài nguyên mới | Một tài nguyên chỉ đọc mới thể hiện thông tin chi tiết về chuyến bay cho một cấu hình đo lường mức tăng, bao gồm cả ngày bắt đầu và ngày kết thúc chuyến bay được đo lường (start_date và end_date). |
| Giải pháp chung | ||
SmartCampaignError |
Giá trị enum mới | Thêm mã lỗi cụ thể mới cho các quy tắc ràng buộc khi tạo chiến dịch Tối đa hoá hiệu suất: |
AuthorizationErrorEnum.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION |
Giá trị enum / lỗi mới | Trả về khi một dự án trên đám mây của Google Cloud có cấp truy cập TEST cố gắng gửi yêu cầu đến một tài khoản không phải tài khoản thử nghiệm. |
| Lập kế hoạch | ||
| Thông tin chi tiết về cảm nhận về thương hiệu | Tính năng mới | Thêm tính năng hỗ trợ thông tin chi tiết về mức độ cảm nhận thương hiệu trong ContentCreatorInsightsService:
|
BenchmarksService cải tiến |
Tính năng mới | Thêm tính năng hỗ trợ các danh mục dưới dạng bộ lọc để xác định phạm vi phân tích điểm chuẩn. Ngoài ra, chúng tôi cũng hỗ trợ các chỉ số quan trọng khác cho doanh nghiệp:
|
| Nhắm mục tiêu theo tình trạng làm cha mẹ | Tính năng mới | Thêm tính năng hỗ trợ nhắm mục tiêu theo tình trạng làm cha mẹ trong công cụ lập kế hoạch tiếp cận. Đã thêm trường mới parental_statuses vào Targeting cho dịch vụ ReachPlanService.GenerateReachForecast và parental_statuses vào PlannableTargeting cho dịch vụ ReachPlanService.ListPlannableProducts. |
| Đề xuất | ||
Recommendation.campaign_specific_app_goal_recommendation |
Đề xuất mới | Đề xuất thêm mục tiêu lượt chuyển đổi đối với ứng dụng theo chiến dịch cụ thể. Tài nguyên EffectiveAutomaticGoal mới được dùng để biểu thị các mục tiêu hiện tại trong đề xuất này. |
| Báo cáo | ||
Metrics.original_conversion_value |
Trường mới | Biểu thị giá trị lượt chuyển đổi ban đầu từ các lượt chuyển đổi có thể đặt giá thầu. Đây là giá trị chưa được điều chỉnh của lượt chuyển đổi trước khi áp dụng bất kỳ mức điều chỉnh nào theo quy tắc về giá trị, chẳng hạn như quy tắc về giá trị lượt chuyển đổi hoặc mức điều chỉnh theo mục tiêu vòng đời. |
| Số liệu thống kê về gói thành viên chương trình khách hàng thân thiết | Tính năng mới | Bổ sung tính năng hỗ trợ phân khúc số liệu thống kê theo trạng thái chương trình thành viên thân thiết của người dùng và thêm phương diện chính của chương trình thành viên thân thiết cho các quy tắc về giá trị lượt chuyển đổi:
|
| Nhắm mục tiêu | ||
vertical_ads_item_bid |
Loại tiêu chí mới | Thêm loại tiêu chí vertical_ads_item_bid mới vào AdGroupCriterion.criterion. |
phiên bản 25 (22/7/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 25 (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 | |||
Các trường độc lập additional_value và additional_high_lifetime_value trong CustomerLifecycleOptimizationValueSettings |
Lần lượt là một phần của value_adjustment và high_lifetime_value_adjustment oneof, cùng với các trường value_multiplier và high_lifetime_value_multiplier mới |
Thay đổi về cấu trúc | Cập nhật các tham chiếu đến những trường này vì chúng hiện là một phần của oneof. |
Tài nguyên CustomerLifecycleGoal và CampaignLifecycleGoal cũ, các dịch vụ tương ứng CustomerLifecycleGoalService và CampaignLifecycleGoalService, cũng như các chế độ cài đặt/enum cũ (CustomerAcquisitionGoalSettings, CustomerAcquisitionOptimizationModeEnum, LifecycleGoalValueSettings) |
Không có | Xoá bỏ | Sử dụng giản đồ mục tiêu hợp nhất được cải tiến:
|
| Giải pháp chung | |||
Các trường enum lồng nhau trong thông báo yêu cầu dịch vụ và phản hồi của Dịch vụ ưu đãi:
|
Các trường enum độc lập: | Đổi tên / xoá | Sử dụng các trường enum độc lập mới thay vì các trường type cũ. |
Các trường selected_incentive_id và customer_id không bắt buộc trong ApplyIncentiveRequest |
Các trường bắt buộc | Sự thay đổi hành vi | Đảm bảo bạn cung cấp cả hai trường khi gọi ApplyIncentive. |
Trường địa chỉ email của người tiêu dùng ContactDetails.email trong tài nguyên LocalServicesLead |
Không có | Xoá bỏ | Xoá các tham chiếu đến trường này vì trường này không còn được hỗ trợ. |
Trường allowed_domain không bắt buộc trong AdvertisingPartnerLinkInvitationProperties |
Trường bắt buộc khi gọi CreateProductLinkInvitation cho một đối tác quảng cáo |
Sự thay đổi hành vi | Hãy nhớ cung cấp allowed_domain khi tạo lời mời liên kết sản phẩm cho đối tác quảng cáo. |
| Lập kế hoạch | |||
Trường search_brand trong GenerateCreatorInsightsRequest |
Không có | Xoá bỏ | Thay vào đó, hãy sử dụng search_topics. |
Trường plannable_location_id trong Targeting và trường cookie_frequency_cap trong GenerateReachForecastRequest |
Không có | Xoá bỏ | Chuyển sang sử dụng plannable_location_ids và cookie_frequency_cap_setting. |
| Báo cáo | |||
Trường customer_metrics trong GenerateBenchmarksMetricsResponse và BreakdownMetrics thuộc loại Metrics |
Trường thuộc loại CustomerMetrics |
Thay đổi loại / thay đổi hành vi | Cập nhật các mối tích hợp để sử dụng loại CustomerMetrics mới. Loại này chỉ chứa các chỉ số đại diện cho hiệu suất quảng cáo của khách hàng. |
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 | ||
AssetAutomationType.GENERATE_ANIMATED_IMAGES_FROM_OTHER_ASSETS |
Giá trị / hành vi enum mới | Có phòng trống trong khoảng thời gian DemandGenMultiAssetAds. Nếu được bật, công cụ này sẽ tạo ảnh động bằng cách sử dụng ảnh tĩnh làm dữ liệu đầu vào. DemandGenMultiAssetAds mới được chọn sử dụng theo mặc định kể từ phiên bản API này. |
| Tính bất biến của thông tin về nội dung nhân tạo | Thay đổi về hành vi | Asset.synthetic_content_info và Ad.synthetic_content_info hiện có thể thay đổi hoàn toàn trong phiên bản 25, 24 và 23. |
| Chiến dịch | ||
| Mục tiêu giữ chân khách hàng thân thiết | Tính năng / chế độ cài đặt mới | Bổ sung tính năng hỗ trợ cho Mục tiêu giữ chân khách hàng thân thiết, cho phép nhà quảng cáo tối ưu hoá chiến dịch để giữ chân thành viên chương trình khách hàng thân thiết.
|
| Mục tiêu thu nạp khách hàng mới | Tính năng / chế độ cài đặt mới | Cập nhật chế độ hỗ trợ Mục tiêu thu nạp khách hàng mới trong Google Ads API để phản ánh giản đồ mục tiêu hợp nhất được cải tiến:
|
| Lượt chuyển đổi | ||
| Phân bổ lượt chuyển đổi của bên thứ ba trên YouTube | Trường mới | Bổ sung tính năng hỗ trợ xác minh mô hình phân bổ lượt chuyển đổi trên YouTube thông qua các đối tác bên thứ ba:
|
| Giải pháp chung | ||
ContactDetails.phone_number_extension |
Trường mới | Đã thêm vào tài nguyên LocalServicesLead. |
IncentiveError |
Giá trị enum và lỗi mới | Thêm mã lỗi mới dành riêng cho trường hợp không sử dụng được ưu đãi:
|
| Lập kế hoạch | ||
| Thông tin chi tiết về kênh YouTube trong thông tin chi tiết về xu hướng | Trường mới | Thêm tính năng hỗ trợ cho các thông tin chi tiết khác về kênh YouTube của video có liên quan khi tìm thông tin chi tiết về xu hướng tìm kiếm. Thêm các trường mới channel_id, channel_name và channel_url vào YouTubeVideoAttributeMetadata. |
YouTubeChannelInsights.data_sharing_consent_given |
Trường mới | Đã thêm vào YouTubeChannelInsights. Điều này áp dụng nếu nhà sáng tạo đã đồng ý chia sẻ dữ liệu không công khai. Nếu có, các trường sau sẽ được điền sẵn:
|
| Báo cáo | ||
ad_sub_format_type |
Phân khúc mới | Cung cấp thông tin chi tiết về quảng cáo trong luồng phát không thể bỏ qua trên YouTube theo thời lượng:
ad_format_type. Bạn có thể chọn bằng AdGroup, AdGroupAd, Campaign, Customer, Video và VideoEnhancement.
|
| Chỉ số trên mạng xã hội dành riêng cho video | Trường / chỉ số mới | Bổ sung các chỉ số mạng xã hội dành riêng cho video để giúp nhà quảng cáo theo dõi mức độ tương tác của người dùng (bình luận, lượt thích và lượt chia sẻ) đối với quảng cáo trên Shorts trên YouTube:
Các phương thức này có trong AdGroup, AdGroupAd, Asset, Campaign, Customer và Video.
|
phiên bản lớn và phiên bản nhỏ v24
Google Ads API phiên bản 24 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 24.2 (24/6/2026)
Google Ads API phiên bản 24.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ư 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 do AI tạo từ trang đích để hiển thị trong bảng điều khiển tương tác cho các thực thể 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 nhằm chọn mặt hàng từ các 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 / lỗi mới | Trả về khi 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 / lỗi mới | Trả về khi 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 | Thêm Google Maps vào 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 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ụ địa phương. |
SmartCampaignErrorEnum.CREATION_FAILED |
Giá trị enum / lỗi mớ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 trước dịch vụ của 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:
|
| 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 tự động phát hiện hoặc cung cấp).
Tính năng này đã được chuyển ngược sang phiên bản 23 và 22.
Để giúp bạn lên kế hoạch cho công việc tích hợp sắp tới cho phiên bản 25, chúng tôi sẽ sớm ra mắt giao diện để thay đổi các trường chứng thực của nhà quảng cáo cho phiên bản 22 trở lên. Giao diện này hiển thị trong các phiên bản này, nhưng Nếu bạn cố gắng thực hiện một yêu cầu thay đổi tài nguyên 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 "Không thể đặt trường". Các trường này sẽ hoàn toàn có thể thay đổi kể từ phiên bản 25. Bạn nên sử dụng giao diện này ngay để xây dựng 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 |
Thêm tính năng hỗ trợ cho quy trình xem xét theo cơ chế Uỷ quyền nhiều bên (MPA):
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 bạn cung cấp một địa chỉ email không hợp lệ 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 giúp tì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 | Đã thêm vào InsightsKnowledgeGraphEntityCapabilities để biểu thị các thực thể cho việc 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 | Dữ liệu đầu vào 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 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 được xem hoặc sinh sống tại quốc gia đã 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 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í tiểu vùng. |
| Báo cáo | ||
PerformanceMaxPlacementView |
Tiện ích phân khúc | Có thể phân đoạn nhờ ad_network_type. |
| 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 mục tiêu 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:
|
Experiment.video_experiment |
Trường mới | Hỗ trợ thiết lập 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:
|
| Giải pháp chung | ||
CustomerUserAccess.passkey_enabled |
Trường mới | Trường chỉ đọc cho biết 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 thiết bị của 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 của thời gian theo ngày, giờ hoặc tuần được yêu cầu không được hỗ trợ cho phạm vi ngày của truy vấn (chỉ áp dụng cho 37 tháng gần 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ố về mức thay đổi tuyệt đối của 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, biên sai số và giá trị p. |
| Nhắm mục tiêu | ||
CriterionErrorEnum.CANNOT_EXCLUDE_ALL_TARGETS |
Giá trị enum / lỗi mới | Trả về khi 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 đường 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 | |||
videos và logo_images không bắt buộc trong DemandGenVideoResponsiveAdInfo |
Các trường bắt buộc | Sự thay đổi 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. |
videos, business_name và logo_images không bắt buộc trong VideoResponsiveAdInfo |
Các trường bắt buộc | Sự thay đổi hành vi | Cung cấp videos, business_name và logo_images khi tạo hoặc thay đổi quảng cáo thích ứng dạng video. 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ỏ | Chế độ kiểm soát mức độ phù hợp ở cấp chiến dịch đã bị xoá. Mức độ phù hợp về sự an toàn cho thương hiệu vẫn được áp dụng ở 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 tham chiếu mã đến lớp này. |
| Lập kế hoạch | |||
Loại InsightsAudienceAttributeGroup cho topic_audience_combinations |
Kiểu common.InsightsAudienceAttributeGroup |
Sự thay đổi hành vi / loại | Bạn phải cập nhật các chế độ tích hợp thư viện ứng dụng được nhập để 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á | 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ự báo từ khoá không dùng nữa trong GenerateKeywordForecastMetrics |
Không có | Xoá | Xoá các trường và loại kế hoạch / dự báo sau: Cập nhật các chế độ tích hợp cho phù hợp. |
| Báo cáo | |||
ad_sub_network_type phân khúc trong campaign_budget |
Không có | Xoá bỏ | Đã xoá phân đoạn ad_sub_network_type cho tài nguyên campaign_budget. |
Phân khúc click_type 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 | |||
Cho phép không thực hiện được một phần trong ShareablePreviewService.GenerateShareablePreviews |
Không có lỗi một phần | Sự thay đổi hành vi | Yêu cầu sẽ không thành công và báo lỗi nếu có bất kỳ mã nhận dạng nào trong đó không xác thực được. |
ShareablePreviewError mã cũ:
|
MutateErrorEnum.RESOURCE_NOT_FOUND ShareablePreviewError.TOO_MANY_RESOURCES_IN_REQUEST |
Đổi tên / sự 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 trong 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 | ||
Tính biến đổi của VideoResponsiveAdInfo |
Thay đổi về hành vi | Giờ đây, bạn có thể thay đổi các đối tượng thông tin của quảng cáo thích ứng dạng video. |
| 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 thành phần 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ừ 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 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 mới của GA4/Firebase trong ConversionActionType:
|
| Giải pháp chung | ||
UserListErrorEnum.DUPLICATE_LOOKALIKE |
Giá trị enum / lỗi mới | Trả về khi cố gắng tạo nhiều danh sách 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 | Cung cấp báo cáo phân đoạn các chỉ số lượt chuyển đổi theo một số sản phẩm cụ thể được 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 thấy 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:
|
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 trong 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 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:
|
Phiên bản lớn và phiên bản 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 và nội dung cập nhật mới 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 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 | ||
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 nhân 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 hiển thị trong các phiên bản này, nhưng Nếu bạn cố gắng thực hiện một yêu cầu thay đổi tài nguyên 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 "Không thể đặt trường". Các trường này sẽ hoàn toàn có thể thay đổi kể 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 v25 ra mắt. |
| Phê duyệt nhiều bên | Tính năng mới |
Bổ sung tính năng hỗ trợ xem xét phê duyệt nhiều bên (MPA):
|
Phiên bản 23.2 (25/3/2026)
Các tính năng và nội dung cập nhật mới 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ư liệu 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ề các 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 khi 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 quy tắc ràng buộc chi tiết hơn về việc lập lịch biểu cho 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ị / lỗi enum mới | Thêm hai 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, một lỗi sẽ xảy ra 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 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 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 | Mở rộng để hỗ trợ bản xem trước YouTube Live 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)
Các tính năng và nội dung cập nhật mới sau đây đã được thêm vào Google Ads API phiên bản 23.1. 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, có thể được dùng 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 lý do cho trạng thái chính của những 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 tính năng hỗ trợ 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ợ 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 một 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 hai 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. |
| 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 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 lược Tối đa hoá lượt chuyển đổi của chiến dịch Tạo nhu cầu. |
GenerateTrendingInsights |
Trường mới | Thêm thông tin về đường xu hướng trong quá khứ trong TrendInsightDataPoint vào 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ố 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 theo ngành dọc, chẳng hạn như nhắm mục tiêu theo thực thể 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, đồng thời 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 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 | |||
| Được phép chia sẻ quảng cáo | AdGroupAdError.AD_SHARING_NOT_ALLOWED |
Sự thay đổi 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 chia sẻ quảng cáo sẽ trả về lỗi AD_SHARING_NOT_ALLOWED. |
Hỗ trợ CallAd và CallAdInfo |
Không có | Xoá | Chúng tôi đã ngừng hỗ trợ quảng cáo tạo cuộc gọi. Tham khảo bài viết trên Trung tâm trợ giúp Giới thiệu về quảng cáo tạo cuộc gọi. |
| 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 các 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 tệp đối chiếu trong mã. |
| Báo cáo | |||
| Chỉ số và enum tổng hợp về nhãn hiệu suất của thành phần | Không có | Xoá | Đã xóa các chỉ số nhãn hiệu suất thành phần tổng hợp. 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 / hỗ trợ mới | Thành phần Tin nhắn cho doanh nghiệp đã cập nhật:
|
| Thanh toán | ||
InvoiceService.ListInvoices |
Tuỳ 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 phí theo quy định và đơn vị đo lường. |
| Chiến dịch | ||
CampaignError |
Giá trị / lỗi enum 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ợ theo dõi những người dùng xem quảng cáo và 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 tính năng hỗ trợ biểu ngữ đi kèm trong quảng cáo dạng 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):
Để 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 |
||
| 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 Sự kiện trong đời bằng tiếng GenerateAudienceCompositionInsights, GenerateSuggestedTargetingInsights, GenerateInsightsFinderReport và GenerateCreatorInsights.
Sự kiện trong đời không được hỗ trợ cho các phương thức |
ReachPlanService.GenerateConversionRates |
Trường / lựa chọn mới | Câu trả lời hiện 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 pháp 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 các đề 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ỉ được đề xuất 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ó 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 thực tế và MatchedLocationInterestView (cho chiến dịch Tối đa hoá AI) để cung cấp chỉ số hiệu suất theo vị trí địa lý quan tâm. |
| Mua sắm | ||
ShoppingPerformanceView |
Hỗ trợ các 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 và 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 mục tiêu 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 nguồn cấp dữ liệu quảng cáo theo ngành 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 về đường liên kết đặt phòng và quảng cáo cơ sở lưu trú 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 quy tắc bằng vertical_ads_item_group_rule. Phân đoạn báo cáo theo phương diện của nguồn cấp dữ liệu quảng cáo theo ngành dọc và AdFormatType. |
| 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 / lỗi mới | Thêm mã lỗi INVALID_VIDEO_LINEUP_ID. |
| 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 được cho quảng cáo dạng âm thanh trên YouTube, báo cáo xem quảng cáo có nghe được hay không và số lượt hiển thị có thể đo lường khả năng nghe được. |
Ghi chú phát hành đã lưu trữ
Hãy xem phần Phiên bản ngừng hoạt động để biết các ghi chú phát hành đã lưu trữ.