Thông báo về phiên bản 17 của API Google Ads

Thứ Tư, ngày 5 tháng 6 năm 2024

Hôm nay, chúng tôi xin thông báo về việc phát hành phiên bản 17 của Google Ads API. Để sử dụng một số tính năng của phiên bản 17, bạn cần nâng cấp thư viện ứng dụng và mã ứng dụng. Các thư viện ứng dụng và mã ví dụ mới nhất sẽ được phát hành vào tuần tới.

Dưới đây là các điểm nổi bật:

• Để chuẩn bị cho thay đổi về chính sách sử dụng tài nguyên sẽ diễn ra vào ngày 17 tháng 6 năm 2024, chúng tôi đã thêm hai giá trị mới vào QuotaError, được gửi khi một mẫu truy vấn tiêu thụ quá nhiều tài nguyên trong một khoảng thời gian cho các yêu cầu GoogleAdsService.Search() và GoogleAdsService.SearchStream().
• Trường page_size luôn được đặt thành 10.000 và bạn không thể truyền page_size đến GoogleAdsService.Search nữa. Nếu không, bạn sẽ gặp lỗi RequestError.PAGE_SIZE_NOT_SUPPORTED.
• Thêm campaign_aggregate_asset_view và channel_aggregate_asset_view để báo cáo thêm các chỉ số của chiến dịch Tối đa hoá hiệu suất và chiến dịch Tìm kiếm.
• Các thay đổi đối với quy trình xử lý hàng loạt:
  • Thêm tính năng hỗ trợ cho việc đặt MutateOperation.asset_group_operation khi sử dụng BatchJobService. Nhờ đó, bạn có thể sử dụng tính năng xử lý hàng loạt để tạo và quản lý toàn bộ chiến dịch Tối đa hoá hiệu suất.
  • Thêm lỗi BatchJobError.REQUEST_TOO_LARGE khi gửi AddBatchJobOperationsRequest lớn hơn 10.484.504 byte. Bạn nên chia các thao tác thành các nhóm nhỏ hơn và gửi chúng dưới dạng một yêu cầu riêng biệt.
• Đã thêm Campaign.keyword_match_type để cho phép đặt kiểu so khớp từ khoá cho tất cả từ khoá trong một chiến dịch.
• Đã xóa AdService.getAd để điều chỉnh dịch vụ cho phù hợp với các dịch vụ khác trong Google Ads API. Để biết các đề xuất về cách tìm nạp tài nguyên, hãy xem phần Truy xuất đối tượng.
• Thêm primary_status và primary_status_reasons vào AdGroupCriterion để cho biết tiêu chí của nhóm quảng cáo có đang phân phát hay không, hoặc lý do tiêu chí đó không phân phát.
• Thêm báo cáo mới shopping_product, tương ứng với trang Sản phẩm trong giao diện người dùng Google Ads.
• Thêm nhiều quy trình xác thực hơn cho ImageAdInfo.image_asset về kích thước và định dạng, giúp quy trình này nhất quán hơn với các quy trình xác thực hình ảnh khác trong API Google Ads.
• Đã thêm segments.sk_ad_network_redistributed_fine_conversion_value để phân phối lại các giá trị NULL cho các giá trị khác dựa trên một mô hình học máy về dữ liệu gần đây của hệ thống đăng lại SkAdNetwork.
• Đổi tên Khám phá thành Tạo nhu cầu trong tất cả các trường, enum, lỗi của mọi tài nguyên trên Google Ads API.
• 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 khi truy vấn product_link. Nếu không làm như vậy, hệ thống sẽ gửi QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE.
• Thêm UserListCustomerTypeService.MutateUserListCustomerTypes() để định cấu hình loại khách hàng của đối tượng. Phương thức này thay thế việc sử dụng CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings.
• Thêm hai trường expiration_date_time local_services_verification_artifact để giúp nhà quảng cáo theo dõi thời điểm hết hạn của cấu phần phần mềm hiệu quả hơn.

Tôi có thể tìm hiểu thêm ở đâu?
Các tài nguyên sau đây có thể giúp bạn bắt đầu:

• Ghi chú phát hành
• Hướng dẫn
• Reference
• Sự khác biệt giữa phiên bản 16 và phiên bản 17

Nếu bạn có câu hỏi hoặc cần được trợ giúp thêm, hãy liên hệ với chúng tôi thông qua diễn đàn.

 – Thanet Knack Praneenararat, thay mặt cho Nhóm Google Ads API

Nhãn: google-ads-api, release