Theo định kỳ, bạn nên nâng cấp từ một phiên bản lớn cũ của API Google Ads lên một phiên bản lớn mới hơn. Có thể là do một phiên bản sắp ngừng hoạt động hoặc có thể là 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 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 các phiên bản lớn. Hãy cập nhật thư viện ứng dụng của bạn để dùng điểm cuối mới nhất.
- Xem qua ghi chú phát hành để xem các thay đổi được giới thiệu 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 vào phiên bản bạn đang nâng cấp lên.
Để biết thông tin tổng quan toàn diện về các thay đổi dựa trên sự khác biệt giữa các protos trong hai phiên bản, hãy tham khảo bảng điểm khác biệt.
phiên bản 16 đến phiên bản 17
| Các thay đổi đối với dịch vụ và thành phần của dịch vụ | |
|---|---|
GoogleAdsService
Search và SearchStream yêu cầu |
Lỗi khi yêu cầu của bạn bị điều tiết vì chi phí quá cao sẽ là |
GoogleAdsService
Search. |
Việc chuyển |
Campaign và Ad |
Thay vào đó, các chiến dịch có Ngoài ra, một số quảng cáo sẽ thay đổi loại và tên trường cho báo cáo:
|
AdService |
Điểm cuối GetAd sẽ bị xoá. Nhờ đó, AdService phù hợp với các dịch vụ khác trong API Google Ads. Hãy xem hướng dẫn của chúng tôi về cách truy xuất đối tượng để biết cách đề xuất để tìm nạp quảng cáo và các loại tài nguyên khác. |
CustomerLifecycleGoal và CampaignLifecycleGoal |
Chúng tôi sẽ điều chỉnh cách quản lý phân đoạn cho các mục tiêu trong vòng đời. Hãy xem mục phân đoạn đối tượng của tài liệu về mục tiêu vòng đời để biết thông tin tổng quan đầy đủ. |
ProductLink |
Giờ đây, khi chạy yêu cầu tìm kiếm hoặc luồng tìm kiếm trên GoogleAdsService cho product_link, bạn hiện chỉ có thể chọn các trường liên quan đến một sản phẩm được liên kết. Việc chọn nhiều trường từ các sản phẩm được liên kết khác nhau sẽ dẫn đến lỗi QuotaError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE. |
| Báo cáo | Đổi tên trường metrics.sk_ad_network_conversion_value thành metrics.sk_ad_network_fine_conversion_value. |
phiên bản 15 đến phiên bản 16
| Các thay đổi đối với dịch vụ và thành phần của dịch vụ | |
|---|---|
AccountLink |
Các đườ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 |
Khi cập nhật CampaignLifecycleGoal hiện có trước đây, bạn sẽ đưa ra thao tác create kèm theo 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 | 2 trường hợp mà lỗi ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT chung được trả về nay 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 hiện sẽ trả về UNSPECIFIED thay vì UNKNOWN cho trường recommended_match_type. |
phiên bản 14 đến phiên bản 15
| Các 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ụ đã bị xoá do 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á. Thông tin hiện được trả về trong trường feed_label.
|
ProductBiddingCategoryConstant
|
Được thay thế bằng
ProductCategoryConstant.
Nhiều trường đã được đổi tên theo, hãy xem ba 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 |
Sau đây là các trường phân đoạn:
|
Campaign.shopping_setting
|
Đã ngừng hỗ trợ tạo chiến dịch Tìm kiếm có trường này. |
CampaignCriterion.listing_scope
|
Đã ngừng hỗ trợ tạo chiến dịch Tìm kiếm có 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 một 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 customerthành: 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 nhằm khám phá danh sách các 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:
YOUTUBE.
|