Hãy tham khảo Ngừng cung cấp tính năng để xem danh sách đã cập nhật về các tính năng hiện tại và dự kiến ngừng cung cấp.
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 bài viết 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 ở 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 tại vẫn giữ nguyên. Giá trị của 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. |
Tính năng và bản cập nhật (không gây lỗi)
| 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ợ LINE và SMS làm nhà cung cấp tin nhắn trong BusinessMessageAsset, bao gồm 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 | Được 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ụ tại đị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 cũng 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 với 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 một chiến dịch Tối đa hoá hiệu suất cho mục tiêu về du lịch cần có một mối liên kết tài khoản Hotel Center đang hoạt động. |
| 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. Trường này 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 mới / lỗ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 | Các 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 Lượt chuyển đổi nâng cao hợp nhất 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 | Đã thêm vào ConversionAttributionEventType để thể hiện 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 do AI tạo cho nội dung 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.
Phiên bản 25.2 (23/9/2026)
Google Ads API phiên bản 25.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 nhỏ như v25.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 | ||
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 dữ liệu tự động về video 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ợ tạo chiến dịch Tối đa hoá hiệu suất 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. Ngoài ra, hãy hiển thị danh mục IN_APP_AD_REVENUE trong ConversionActionCategory để theo dõi doanh thu từ hoạt động kiếm tiền bằng 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, API hiện trả về BusinessProfileLocationSyncError với các 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
Đã thêm tính năng hỗ trợ các chỉ số phân vị cho ngày của quý đang mở trong Thêm 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ư 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 trên YouTube được yêu cầu. |
| Đề 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ợ 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 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 ngành 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 đoạn sau đây cho báo cáo quảng cáo ngành 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 phụ như v25.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ả |
|---|---|---|
| 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 | ||
| Đ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:
|
| Đo lường Mức tăng lượt chuyển đổi | Tính năng mới | Bổ sung tính năng hỗ trợ cho các phép đo lường Mức tăng lượt chuyển đổi với những nội dung cập nhật sau:
|
LiftMeasurementFlight |
Tài nguyên mới | Một tài nguyên mới chỉ có thể đọc, đại diện cho thông tin chi tiết về chuyến bay cho 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 về việc 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 đưa ra yêu cầu đối với một tài khoản không phải tài khoản kiểm thử. |
| 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 tính năng nâng cao |
Tính năng mới | Thêm tính năng hỗ trợ cho 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 để thể hiện 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 | Thể hiện giá trị lượt chuyển đổi ban đầu từ 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 | Thêm tính năng hỗ trợ phân đoạn số liệu thống kê theo trạng thái chương trình thành viên khách hàng 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 khách hàng thân thiết cho 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 bài viết 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, 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á | 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:
|
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 không bắt buộc selected_incentive_id và customer_id 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á | 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, tính năng này sẽ tạo ảnh động bằng cách sử dụng ảnh không động 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 | Đã thêm tính năng hỗ trợ xác minh mô hình phân bổ giá trị đóng góp cho lượt chuyển đổi trên YouTube bằng 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 cụ thể mới cho các 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 API 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 | Hỗ trợ thêm thông tin về 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 | Hỗ trợ thêm cho 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 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 | 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 / lỗi mớ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 mới / lỗi | Trả về khi 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ậ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 Nếu bạn cố gắng gửi yêu cầu thay đổi tài nguyên trên một trong hai trường này, thì hệ thống sẽ trả về một trong các lỗi sau: "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. |
| 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 | Đượ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ả cá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 | Đầ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 thông tin về vị trí hoặc thuộc tính của nhà sáng tạo trong 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 tại đị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 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 / lỗi mớ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)
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 24.1. Các phiên bản nhỏ như phiên bản 24.1 không 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ó thể đọ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 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 giá trị đối chứng (control_clicks, v.v.), giá trị thử nghiệm (clicks, v.v.), giá trị ước tính điểm (clicks_point_estimate, v.v.), biên 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 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, tỷ lệ 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 dưới dạng đối tác tích hợp khả năng xem của bên thứ ba. |
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 | |||
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á | Chế độ kiểm soát mức độ phù hợp ở cấp chiến dịch đã bị xoá. 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 mã đến đối tượng đó. |
| 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á bỏ | Xoá các trường và loại kế hoạch / dự báo sau: Cập nhật các ứng dụng 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. |
Phân khúc click_type trong chế độ xem thành phần |
Không có | Xoá bỏ | Đã xóa phân đoạn khỏi các chế độ xem AdGroupAsset, CampaignAsset và CustomerAsset. |
| Video | |||
Được 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 sẽ đượ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 thành phầ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ừ 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 | ||
| 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 GA4/Firebase mới 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 | Ra mắt tính năng lọc bằ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 trực tiếp cung cấ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 Nếu bạn cố gắng gửi yêu cầu thay đổi tài nguyên trên một trong hai trường này, thì hệ thống sẽ trả về một trong các lỗi sau: "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 nhỏ như phiên bản 23.2 không 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ề 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 tính 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ợ cho các kiểu kết hợp VÀ/HOẶC 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 mới có thể nhắm đến, 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 các lý do chính về trạng thái cho 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 quảng cáo và sau đó xem video trên cùng một kênh. |
| Giải pháp chung | ||
CriterionErrorEnum.CANNOT_TARGET_ONLY_UNDETERMINED |
Giá trị enum / lỗi mới | Được trả về khi cố gắng chỉ nhắm mục tiêu 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 dịch Tạo nhu cầu với mục tiêu 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 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 bài viết 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 phép chia sẻ quảng cáo giữa nhiều nhóm quảng cáo nữa. 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á | Quảng cáo tạo cuộc gọi không còn được hỗ trợ nữa. 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 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á | Đã 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ố tổng hợp về nhãn hiệu suất của thành phầ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. |
Tính năng và bản cập nhật (không gây lỗi)
| 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 chế độ 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ó thể đọ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 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 chia thành từng khoản 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 | Bổ sung tính năng hỗ trợ 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 Tự chọ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 | Giờ đây, phản hồi bao gồm các nền tảng để hỗ trợ đề xuất về 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 | Đã 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 trên 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 nhà sáng tạo đối với một chủ đề, được tính theo trọng 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ợ chỉ số / tính năng 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, tính năng này được cung cấp 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). Phải được 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 và value_per_all_conversions_by_conversion_date. |
ShoppingPerformanceView |
Hỗ trợ các 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 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 trên bao nhiêu lượt hiển thị. |
Ghi chú phát hành đã lưu trữ
Hãy xem phần Các phiên bản không còn được hỗ trợ để xem ghi chú phát hành được lưu trữ.