Pengumuman Google Ads API v17

Rabu, 5 Juni 2024

Hari ini, kami mengumumkan rilis v17 Google Ads API. Untuk menggunakan beberapa fitur v17, Anda harus mengupgrade library klien dan kode klien. Library klien dan contoh kode yang diperbarui akan dipublikasikan minggu depan.

Berikut ini sorotannya:

• Untuk mempersiapkan perubahan kebijakan penggunaan resource yang akan terjadi pada 17 Juni 2024, kami menambahkan dua nilai baru ke QuotaError, yang ditampilkan untuk konsumsi resource yang berlebihan selama jangka waktu tertentu oleh pola kueri untuk permintaan GoogleAdsService.Search() dan GoogleAdsService.SearchStream().
• Kolom page_size selalu ditetapkan ke 10.000, dan Anda tidak dapat lagi meneruskan page_size ke GoogleAdsService.Search. Tindakan tersebut akan menghasilkan error RequestError.PAGE_SIZE_NOT_SUPPORTED.
• Menambahkan campaign_aggregate_asset_view dan channel_aggregate_asset_view untuk melaporkan lebih banyak metrik kampanye Performa Maksimal dan Penelusuran.
• Perubahan pada pemrosesan batch:
  • Menambahkan dukungan untuk menyetel MutateOperation.asset_group_operation saat menggunakan BatchJobService. Dengan demikian, Anda dapat menggunakan pemrosesan batch untuk membuat dan mengelola seluruh kampanye Performa Maksimal.
  • Menambahkan error BatchJobError.REQUEST_TOO_LARGE untuk pengiriman AddBatchJobOperationsRequest yang lebih besar dari 10.484.504 byte. Anda harus membagi operasi menjadi grup yang lebih kecil dan mengirimkannya sebagai permintaan terpisah.
• Menambahkan Campaign.keyword_match_type untuk memungkinkan penetapan jenis pencocokan kata kunci untuk semua kata kunci dalam kampanye.
• Menghapus AdService.getAd untuk menyelaraskan layanan dengan layanan lainnya di Google Ads API. Untuk rekomendasi tentang cara mengambil resource, lihat Mengambil objek.
• Menambahkan primary_status dan primary_status_reasons ke AdGroupCriterion untuk menunjukkan apakah kriteria grup iklan ditayangkan, atau alasan kriteria tersebut tidak ditayangkan.
• Menambahkan laporan baru shopping_product, yang sesuai dengan halaman Produk di UI Google Ads.
• Menambahkan lebih banyak validasi untuk ImageAdInfo.image_asset terkait dimensi dan format, sehingga lebih konsisten dengan validasi gambar lainnya di Google Ads API.
• Menambahkan segments.sk_ad_network_redistributed_fine_conversion_value, yang mendistribusikan ulang nilai NULL ke nilai lain berdasarkan model machine learning pada data postback SkAdNetwork terbaru.
• Mengganti nama Discovery menjadi Demand Gen di semua kolom, enum, error dari semua resource di Google Ads API.
• Sekarang Anda hanya dapat memilih kolom yang terkait dengan satu produk tertaut saat membuat kueri product_link. Jika tidak, QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE akan ditampilkan.
• Menambahkan UserListCustomerTypeService.MutateUserListCustomerTypes() untuk mengonfigurasi jenis pelanggan audiens. Metode ini menggantikan penggunaan CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings.
• Menambahkan dua kolom expiration_date_time local_services_verification_artifact agar pengiklan dapat memantau dengan lebih baik kapan masa berlaku artefak mereka berakhir.

Di mana saya bisa mendapatkan informasi selengkapnya?
Referensi berikut dapat membantu Anda memulai:

• Catatan Rilis
• Panduan
• Referensi
• Perbedaan antara v16 dan v17

Jika ada pertanyaan atau memerlukan bantuan lain, hubungi kami melalui forum.

 - Thanet Knack Praneenararat, atas nama Tim Google Ads API

Label: google-ads-api, release