Theo định kỳ, bạn có thể muố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. 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 biểu ngừng sử dụng của chúng tôi để lên kế hoạch nâng cấp. 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 hoạt động.
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 chính. Cập nhật thư viện ứng dụng để sử dụng điểm cuối mới nhất.
- Xem ghi chú phát hành để biết những thay đổi được đưa ra trong từng bản phát hành.
- Hãy xem các bảng bên dưới để biết những khía cạnh cụ thể cần tập trung cho phiên bản mà bạn đang nâng cấp lên.
Để xem thông tin tổng quan toàn diện về những thay đổi dựa trên sự khác biệt giữa các protos cho hai phiên bản, hãy xem bảng điểm khác biệt.
Phiên bản 17 đến phiên bản 18
Các thay đổi đối với dịch vụ và thành phần của dịch vụ | |
---|---|
GoogleAdsService
Search và yêu cầu SearchStream |
Lỗi khi yêu cầu của bạn bị điều tiết vì quá tốn kém sẽ là |
GoogleAdsService |
summary_row_setting và
return_total_results_count trường trong SearchGoogleAdsRequest
hiện là một phần của đối tượng SearchSettings mới. |
AssetType |
Giá trị enum DISCOVERY_CAROUSEL_CARD đã được đổi tên thành DEMAND_GEN_CAROUSEL_CARD . Điều này phù hợp với một thay đổi trước đó
để đổi tên chiến dịch Khám phá thành chiến dịch Tạo nhu cầu. |
AudienceInsightsService.GenerateSuggestedTargetingInsights |
Các trường audience , baseline_audience và data_month đã được di chuyển trong trường audience_definition . |
DemandGenCampaignSettings |
Giá trị mặc định của trường upgraded_targeting hiện là
true thay vì false . |
LocalServicesLeadConversation |
Trường phone_call_details.call_recording_url sẽ không còn nữa
được điền sẵn cho các lệnh gọi tĩnh. |
Phiên bản 16 đến phiên bản 17
Thay đổi đối với các dịch vụ và thành phần của dịch vụ | |
---|---|
GoogleAdsService
Search và yêu cầu SearchStream |
Yêu cầu của bạn có thể bị điều tiết nếu truy vấn quá tốn kém. Nếu có,
bạn sẽ gặp lỗi |
GoogleAdsService
yêu cầu Search . |
Việc truyền |
Campaign và Ad |
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 để báo cáo:
|
AdService |
Điểm cuối GetAd sẽ bị xoá. Điều này mang lại
AdService phù hợp với các dịch vụ khác trong API Google Ads. Xem
hướng dẫn về cách truy xuất
đối tượng để tìm nạp quảng cáo và các loại tài nguyên khác theo cách đề xuất. |
CustomerLifecycleGoal
và CampaignLifecycleGoal |
Chúng tôi sẽ thay đổi cách bạn quản lý phân đoạn cho các mục tiêu trong vòng đời. Hãy xem phần phân khúc đối tượng trong tài liệu về mục tiêu trong vòng đời để biết thông tin tổng quan đầy đủ. |
ProductLink |
Khi chạy yêu cầu tìm kiếm GoogleAdsService hoặc luồng tìm kiếm cho product_link , giờ đây, bạ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. 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
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 . |