Theo định kỳ, bạn nên nâng cấp từ phiên bản lớn cũ của API Google Ads lên phiên bản lớn mới. Nguyên nhân có thể là do một phiên bản sắp ngừng hoạt động hoặc có thể là do bạn muốn sử dụng một tính năng mới. Bạn nên luôn nâng cấp lên phiên bản mới nhất.
Hãy xem lịch ngừng sử dụng của chúng tôi để lên kế hoạch nâng cấp. Hãy xem hướng dẫn tạo phiên bản của chúng tôi để tìm hiểu cách hoạt động của tính năng tạo phiên bản.
Dưới đây là danh sách kiểm tra để giúp bạn bắt đầu quá trình nâng cấp:
- Điểm cuối của bạn sẽ thay đổi khi bạn thay đổi phiên bản lớn. Cập nhật thư viện ứng dụng để sử dụng điểm cuối mới nhất.
- Xem qua ghi chú phát hành để xem những thay đổi được ra mắt trong mỗi bản phát hành.
- Hãy xem các bảng dưới đây để biết những khía cạnh cụ thể cần tập trung cho phiên bản bạn đang nâng cấp.
Để biết thông tin tổng quan toàn diện về các thay đổi dựa trên điểm khác biệt giữa các proto của 2 phiên bản, hãy xem bảng điểm khác biệt.
phiên bản 15 đến phiên bản 16
| Những thay đổi đối với dịch vụ và thành phần của dịch vụ | |
|---|---|
AccountLink |
Đường liên kết data_partner và google_ads trong linked_account đã bị xoá. Thay vào đó, hãy sử dụng ProductLinkService và ProductLinkInvitationService. |
CampaignLifecycleGoal |
Trước đây, khi cập nhật một CampaignLifecycleGoal hiện có, bạn sẽ đưa ra một thao tác create với các yêu cầu cụ thể.
Giờ đây, bạn có thể thực hiện thao tác update giống như với các loại tài nguyên khác. |
| Error reporting | Có 2 trường hợp lỗi
ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT chung được trả về
hiện sẽ dẫn đến các thông báo lỗi cụ thể hơn:
|
AudienceInsightsAttributeMetadata |
Trường score đã bị xoá. |
KeywordMatchTypeRecommendation |
Nếu bạn không đặt kiểu khớp từ khoá, thì API sẽ trả về UNSPECIFIED thay vì UNKNOWN cho trường recommended_match_type. |
phiên bản 14 đến phiên bản 15
| Những thay đổi đối với dịch vụ và thành phần của dịch vụ | |
|---|---|
AssetGroupListingGroupFilter
|
Trường enum vertical được đổi tên thành feed_type.
|
MediaFileService
|
Dịch vụ này đã bị xoá vì không còn cần thiết nữa.
Hãy xem thay đổi về ImageAdInfo ở bên dưới.
|
ImageAdInfo
|
Trường media_file đã được thay thế bằng image_asset.
|
MerchantCenterLinkService
|
Dịch vụ này đã được thay thế bằng
ProductLinkInvitationService và
ProductLinkService.
|
Campaign.ShoppingSetting
|
Trường sales_country đã bị xoá. Hiện tại, thông tin sẽ được trả về trong trường feed_label.
|
ProductBiddingCategoryConstant
|
Thay thế bằng
ProductCategoryConstant.
Nhiều trường đã được đổi tên tương ứng, xem 3 thay đổi tiếp theo ở bên dưới.
|
ListingDimensionInfo
|
Thay thế trường product_bidding_category bằng product_category.
|
ListingGroupFilterDimension
|
Thay thế trường product_bidding_category bằng product_category.
|
Báo cáo shopping_performance_view |
Các trường phân đoạn sau đây:
|
Campaign.shopping_setting
|
Đã ngừng hỗ trợ việc tạo chiến dịch Tìm kiếm với trường này. |
CampaignCriterion.listing_scope
|
Đã ngừng hỗ trợ việc tạo chiến dịch Tìm kiếm với trường này. |
Báo cáo sk_ad_network_conversions |
metrics.sk_ad_network_conversions đã được thay thế bằng metrics.sk_ad_network_installs.
|
OfflineConversionClientSummary
|
Di chuyển trường offline_conversion_client_summaries từ
Customer sang tài nguyên cấp cao nhất mà bạn có thể truy vấn riêng.
Thay đổi truy vấn của bạn từ: SELECT customer.offline_conversion_client_summaries FROM customerđến: SELECT offline_conversion_upload_client_summary.client, offline_conversion_upload_client_summary.status, offline_conversion_upload_client_summary.total_event_count, offline_conversion_upload_client_summary.successful_event_count, offline_conversion_upload_client_summary.last_upload_date_time, ... FROM offline_conversion_upload_client_summary Sử dụng trình tạo truy vấn để khám phá danh sách trường có sẵn để chọn và lọc. |
OfflineConversionUploadAlert
|
Đã đổi tên thành
OfflineConversionAlert. |
OfflineConversionUploadError
|
Đã đổi tên thành
OfflineConversionError. |
AdNetworkType
|
Các enum
YOUTUBE_SEARCH và
YOUTUBE_WATCH đã được hợp nhất thành một enum duy nhất:
YOUTUBE.
|