Ingin menyampaikan masukan tentang Google Ads API? Daftar untuk diundang berpartisipasi dalam riset pengguna.

Halaman ini diterjemahkan oleh Cloud Translation API.

Catatan Rilis

v19 (26-02-2025)

Fitur dan perubahan berikut ditambahkan di v19.

Pengelolaan Akun

Menambahkan nilai berikut ke CustomerError untuk memperhitungkan perubahan mendatang:
- CREATION_DENIED_FOR_POLICY_VIOLATION
- CREATION_DENIED_INELIGIBLE_MCC

Aset

(Khusus untuk akun yang diizinkan) Menambahkan dukungan untuk aset pesan melalui Asset.business_message_asset, BusinessMessageAsset, serta enum dan error berikut.
- Enum:
- Error:
  - AssetError.CUSTOMER_NOT_ON_ALLOWLIST_FOR_WHATSAPP_MESSAGE_ASSETS
  - ResourceLimitType
Menambahkan AssetAutomationType.GENERATE_LANDING_PAGE_PREVIEW untuk mendukung pembuatan pratinjau halaman landing secara otomatis.
AssetAutomationType.GENERATE_SHORTER_YOUTUBE_VIDEOS kini diikutsertakan secara default untuk iklan responsif video Peningkat Permintaan.
(Khusus untuk akun yang diizinkan; daftar yang diizinkan saat ini ditutup) Menambahkan Asset.app_deep_link_asset dan AppDeepLinkAsset.

Konversi

Sasaran konversi
- LifecycleGoalValueSettings.high_lifetime_value tidak lagi dalam versi beta dan kini dapat diubah.
- Menambahkan CustomerLifecycleGoal.owner_customer untuk menampilkan nama resource pelanggan yang memiliki tujuan siklus proses pelanggan.
ConversionActionType.SALESFORCE tidak digunakan lagi.

Feed

Menghapus semua entity terkait feed, seperti Feed, FeedMapping, FeedService, AdGroupFeed, feed_placeholder_view, dll. Pengguna kini harus menggunakan aset untuk mencapai tujuan yang sama. Buka Catatan Migrasi untuk melihat daftar semua entitas yang dihapus.

Hotel & Perjalanan

Membuat min_days dan max_days dari ValueRuleItineraryAdvanceBookingWindow kolom optional untuk memungkinkan menentukan 0 sebagai nilai. Hal ini mendukung penargetan untuk penelusuran perjalanan yang terjadi hari ini.

Performa Maks

(Khusus akun yang diizinkan) Pedoman merek
- Membuat Campaign.brand_guidelines_enabled dapat diubah hanya saat membuat kampanye Performa Maksimal.
- Hal ini tidak kompatibel dengan Performa Maksimal untuk sasaran perjalanan.
- Untuk mengaktifkan panduan merek bagi kampanye Performa Maksimal yang ada, gunakan CampaignService.EnablePMaxBrandGuidelines yang baru ditambahkan. Menonaktifkan pedoman merek tidak didukung.
- Menambahkan Campaign.brand_guidelines dan BrandGuidelines untuk memungkinkan penetapan warna dan jenis font merek.
- Nilai error baru:
  - BatchJobError.CAMPAIGN_AND_CAMPAIGN_ASSET_TRANSACTION_FAILURE
  - BrandGuidelinesMigrationError
- CampaignError
  - BRAND_GUIDELINES_NOT_ENABLED_FOR_CAMPAIGN
  - BRAND_GUIDELINES_MAIN_AND_ACCENT_COLORS_REQUIRED
  - BRAND_GUIDELINES_COLOR_INVALID_FORMAT
  - BRAND_GUIDELINES_UNSUPPORTED_FONT_FAMILY
  - BRAND_GUIDELINES_UNSUPPORTED_CHANNEL
  - CANNOT_ENABLE_BRAND_GUIDELINES_FOR_TRAVEL_GOALS
  - CUSTOMER_NOT_ALLOWLISTED_FOR_BRAND_GUIDELINES
Menambahkan AssetAutomationType.GENERATE_ENHANCED_YOUTUBE_VIDEOS untuk mendukung pembuatan aset video yang ditingkatkan secara otomatis untuk kampanye Performa Maksimal.

Perencanaan

(Khusus untuk akun yang diizinkan) Menambahkan ContentCreatorInsightsService.GenerateTrendingInsights yang memungkinkan pengguna melihat topik konten trending di YouTube untuk definisi penonton tertentu.
Menambahkan GenerateCreatorInsightsRequest.country_locations[] untuk menentukan negara yang akan menelusuri kriteria yang diberikan
Menambahkan GenerateCreatorInsightsRequest.search_brand untuk menentukan merek yang akan digunakan untuk menelusuri kreator
Menambahkan kolom baru ke YouTubeChannelInsights untuk memberikan informasi saluran tambahan untuk permintaan search_channels:
- channel_url
- channel_description
- top_videos
Menambahkan kolom metadata baru ke AudienceInsightsAttributeMetadata:
- youtube_video_metadata
- user_interest_attribute_metadata
- knowledge_graph_attribute_metadata

Video

Setelah rilis DataLinkService.CreateDataLink, kami menambahkan metode berikut untuk memungkinkan mutasi link data yang dibuat sebelumnya:
- RemoveDataLink untuk menghapus penautan data di akun Google Ads
- UpdateDataLink untuk menerima, menolak, dan mencabut penautan data di akun Google Ads
Menghapus dukungan untuk VIDEO_OUTSTREAM dari enum berikut:

v18 (16-10-2024)

Fitur baru dan update berikut ditambahkan di v18.

Pengelolaan Akun

(Khusus untuk akun yang diizinkan) Menambahkan DataLinkService.CreateDataLink, yang memungkinkan penautan akun Google Ads ke video kreator yang dihosting di channel YouTube kreator. Penautan video memungkinkan akun Google Ads menjalankan iklan kemitraan menggunakan video kreator.

Grup Iklan

Menambahkan AdGroup.exclude_demographic_expansion yang memungkinkan Anda mengecualikan demografi agar tidak diperluas saat optimized_targeting_enabled adalah true, fitur yang sebelumnya hanya didukung untuk Peningkat Permintaan.

Menambahkan AdGroupAd.ad_group_ad_asset_automation_settings, yang memungkinkan iklan memilih untuk ikut serta atau tidak dalam pembuatan aset otomatis.
Menambahkan nilai berikut ke AssetAutomationType:
- GENERATE_VERTICAL_YOUTUBE_VIDEOS
- GENERATE_SHORTER_YOUTUBE_VIDEOS
Menambahkan AdNetworkType.GOOGLE_OWNED_CHANNELS, yang digunakan oleh iklan yang ditayangkan di saluran milik Google seperti YouTube, Gmail, dan feed Discover.

Aset

Mengganti nama AssetType.DISCOVERY_CAROUSEL_CARD menjadi AssetType.DEMAND_GEN_CAROUSEL_CARD.

Kampanye

Menambahkan metrics.store_visits_last_click_model_attributed_conversions, yang menampilkan jumlah kunjungan toko yang diatribusikan oleh model klik terakhir kampanye.
Menambahkan metrik terkait penayangan video berikut untuk kampanye:
Menambahkan metrics.results_conversions_purchase, yang menampilkan pembelian konversi untuk hasil sasaran terpadu kampanye.
Mengubah nilai default DemandGenCampaignSettings.upgraded_targeting dari false menjadi true.

Kriteria

Menambahkan content_criterion_view yang menampilkan metrik performa konten yang ditargetkan, seperti kata kunci, penempatan, dan topik, untuk kampanye Display, Peningkat Permintaan, dan Video.

Hotel & Perjalanan

Dukungan untuk Feed Perjalanan di Iklan Penelusuran
- Menambahkan ClickType.TRAVEL_ASSETS untuk memungkinkan segmentasi metrik Feed Perjalanan di Iklan Penelusuran.
- Menambahkan AssetSetType.TRAVEL_FEED yang dapat digunakan untuk memilih ikut serta dan memilih tidak ikut menggunakan Feed Perjalanan di Iklan Penelusuran.
(Khusus untuk akun yang diizinkan) Menambahkan itinerari perjalanan sebagai aturan nilai konversi baru dengan kolom dan nilai baru berikut:
- ConversionValueRule.itinerary_condition dengan ValueRuleItineraryCondition, yang memungkinkan Anda menentukan periode pemesanan di awal, durasi itinerari, dan hari mulai perjalanan
- ConversionValueRulePrimaryDimensionEnum.ITINERARY
- ValueRuleSetDimension.ITINERARY
Menambahkan segmen berikut untuk laporan campaign dan ad_group guna memungkinkan segmentasi data performa berdasarkan tujuan tertentu (kota, negara, dan wilayah) untuk kampanye Hotel dan Penelusuran:

Layanan Lokal

PhoneCallDetails.call_recording_url akan kosong, bukan memberikan URL yang tidak valid jika rekaman panggilan tidak ada untuk percakapan prospek Layanan Lokal tertentu.
Menambahkan CategoryBid.target_cpa_bid_micro yang memungkinkan penetapan target CPA untuk kategori melalui Campaign.local_services_campaign_settings.

Performa Maks

Dukungan untuk pedoman merek
- Menambahkan Campaign.brand_guidelines_enabled yang menunjukkan apakah pedoman merek diaktifkan untuk kampanye Performa Maksimal tertentu. Jika diaktifkan, aset dengan field_type yang ditetapkan ke BUSINESS_NAME, LOGO, LANDSCAPE_LOGO harus ditautkan sebagai resource CampaignAsset, bukan resource AssetGroupAsset.
- Menambahkan error CampaignError.REQUIRED_BUSINESS_NAME_ASSET_NOT_LINKED dan CampaignError.REQUIRED_LOGO_ASSET_NOT_LINKED, yang menunjukkan bahwa kampanye Performa Maksimal dengan pedoman merek diaktifkan tidak memiliki resource CampaignAsset yang diperlukan yang ditautkan ke kampanye.
- Jika pedoman merek diaktifkan, minimal satu aset dengan field_type yang ditetapkan ke BUSINESS_NAME dan minimal satu aset dengan LOGO harus ditautkan ke kampanye sebagai resource CampaignAsset. Kampanye Performa Maksimal untuk penjualan online dengan feed produk harus memenuhi persyaratan ini hanya jika ada aset yang ditautkan ke grup aset kampanye.
- Menambahkan nilai berikut ke AssetLinkError:
  - BRAND_ASSETS_NOT_LINKED_AT_ASSET_GROUP_LEVEL, yang ditampilkan saat mencoba menautkan aset merek ke kampanye sebagai resource CampaignAsset, bukan resource AssetGroupAsset di kampanye Performa Maksimal dengan panduan merek tidak diaktifkan.
  - Error BRAND_ASSETS_NOT_LINKED_AT_CAMPAIGN_LEVEL, yang ditampilkan saat mencoba menautkan aset merek ke kampanye sebagai resource AssetGroupAsset, bukan resource CampaignAsset di kampanye Performa Maksimal dengan pedoman merek diaktifkan.
Menambahkan performance_max_placement_view yang menampilkan tayangan iklan dari penempatan tempat iklan Performa Maksimal ditayangkan.
AssetGroupListingGroupFilterError.TREE_WAS_INVALID_BEFORE_MUTATION ditambahkan

Perencanaan

(Khusus untuk akun yang diizinkan) Menambahkan layanan baru dengan metode ContentCreatorInsightsService.GenerateCreatorInsights, yang memungkinkan pengguna menjelajahi insight tentang Kreator YouTube teratas. Hal ini memungkinkan pelanggan menelusuri kreator berdasarkan kombinasi penargetan audiens dan penargetan konten atau insight kreator berdasarkan daftar ID Channel YouTube.
Pembaruan pada AudienceInsightsService.GenerateSuggestedTargetingInsights:
- Memindahkan audience, baseline_audience, dan data_month ke audience_definition.
- Menambahkan audience_description untuk membuat saran penargetan dari deskripsi teks bentuk bebas menggunakan Gen AI.
Menambahkan AudienceInsightsService.GenerateTargetingSuggestionMetrics yang menampilkan metrik potensi jangkauan untuk kombinasi penargetan audiens tertentu.

Rekomendasi

RecommendationService.GenerateRecommendations kini dapat digunakan untuk membuat rekomendasi tentang saran anggaran yang dioptimalkan selama pembuatan kampanye, dengan menyertakan jenis rekomendasi CAMPAIGN_BUDGET di GenerateRecommendationsRequest.recommendation_types[]. Hal ini berlaku untuk kampanye Performa Maksimal dan Penelusuran.

Pelaporan

Mengganti kolom summary_row_setting dan return_total_results_count dari SearchGoogleAdsRequest dengan kolom search_settings, yang jenisnya adalah SearchSettings dengan kolom berikut:
- omit_results
- return_summary_row
- return_total_results_count
Menambahkan metrik baru berikut tentang klik tidak valid umum, seperti klik yang dihasilkan oleh bot atau crawler, klik yang memiliki pola tidak teratur. Data tersebut dapat dikueri dengan laporan campaign.
- metrics.general_invalid_clicks
- metrics.general_invalid_click_rate
Menambahkan nilai berikut ke QuotaError:
- EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION
- EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION

v17.1.0 (07-08-2024)

Fitur baru dan update berikut ditambahkan di v17_1.

Aset

AdGroupAdService.RemoveAutomaticallyCreatedAssets() memungkinkan Anda menghapus aset yang dibuat otomatis yang ditentukan dan ditautkan ke Iklan Penelusuran Responsif.

Audiens

Nilai enum baru di UserListCustomerTypeCategory:
- LOYALTY_TIER_1_MEMBERS
- LOYALTY_TIER_2_MEMBERS
- LOYALTY_TIER_3_MEMBERS
- LOYALTY_TIER_4_MEMBERS
- LOYALTY_TIER_5_MEMBERS
- LOYALTY_TIER_6_MEMBERS
- LOYALTY_TIER_7_MEMBERS

Kampanye

ShareablePreviewService.GenerateShareablePreviews() membuat URL (shareable_preview_url dalam respons) untuk pratinjau iklan yang dapat dibagikan untuk grup aset yang diaktifkan dan dijeda.
- Kolom expiration_date_time menunjukkan tanggal habis masa berlaku URL dalam respons.
- Jika terjadi error, metode akan menampilkan partial_failure_error, bukan URL.

Histori Perubahan

Jenis resource status perubahan baru: ASSET_GROUP.

Konversi

Kolom segmen baru untuk versi SKAdNetwork: segments.sk_ad_network_version
offline_conversion_upload_conversion_action_summary yang menampilkan diagnostik upload konversi di tingkat tindakan konversi.
Metrik berikut ditambahkan ke laporan diagnostik offline untuk menyampaikan jumlah konversi yang diupload yang masih diproses:
- offline_conversion_upload_client_summary
  - pending_event_count
  - pending_rate
- offline_conversion_upload_conversion_action_summary:
  - pending_count

Perencanaan

AudienceInsights.GenerateAudienceOverlapInsights() yang menerima atribut utama input dan kumpulan atribut audiens, serta menampilkan estimasi tumpang-tindih potensi jangkauan YouTube antara atribut utama dan atribut audiens.

Pelaporan

Dukungan untuk menyegmentasikan per_store_view berdasarkan segments.date

Video

Dukungan untuk mengambil informasi terkait strategi bidding standar berikut untuk kampanye video menggunakan laporan, seperti, ad_group, campaign:
- Campaign.fixed_cpm (CPM tetap (biaya per seribu tayangan iklan))
- Campaign.target_cpv (Target CPV (biaya per tampilan))
Campaign.video_campaign_settings yang memungkinkan Anda menentukan inventaris tempat iklan video dapat ditampilkan, menggunakan kolom laporan berikut:
segments.ad_format_type yang memungkinkan Anda menyegmentasikan laporan berikut berdasarkan jenis format iklan video:

v17 (05-06-2024)

Fitur dan perubahan berikut ditambahkan di v17.

AdService.getAd dihapus. Hal ini membuat AdService selaras dengan layanan lain di Google Ads API. Lihat Mengambil objek untuk mengetahui cara yang direkomendasikan untuk mengambil iklan dan jenis resource lainnya.
Menambahkan validasi lainnya untuk ImageAdInfo.image_asset terkait dimensi dan format. Error berikut dapat ditampilkan jika gambar tidak valid:
- ImageError.UNEXPECTED_SIZE
- ImageError.FORMAT_NOT_ALLOWED

Aset

Menambahkan enum baru: ClickType.AD_IMAGE
Menambahkan laporan baru berikut dengan metrik baru untuk kampanye Performa Maksimal dan Penelusuran:
- campaign_aggregate_asset_view
- channel_aggregate_asset_view

Audiens

OfflineUserDataJobError.OPERATION_LEVEL_CONSENT_PROVIDED ditambahkan

Tugas Batch

Menambahkan BatchJobError.REQUEST_TOO_LARGE, yang akan ditampilkan saat AddBatchJobOperationsRequest yang dikirim lebih besar dari 10484504 byte.
Menambahkan dukungan untuk menyetel MutateOperation.asset_group_operation saat menggunakan BatchJobService. Hal ini memungkinkan Anda menggunakan pemrosesan batch untuk membuat dan mengelola seluruh kampanye Performa Maksimal. Lihat panduan khusus kami yang baru.

Kampanye

Mengganti nama Discovery menjadi Peningkat Permintaan di semua kolom, enum, error dari semua resource di Google Ads API, seperti kampanye, iklan, dan aset. Misalnya, AdvertisingChannelType.DISCOVERY kini AdvertisingChannelType.DEMAND_GEN.
Menambahkan Campaign.keyword_match_type agar Anda dapat menetapkan jenis pencocokan kata kunci untuk semua kata kunci dalam kampanye.

Konversi

Untuk konversi SKAdNetwork,
- Mengganti nama segments.sk_ad_network_conversion_value menjadi segments.sk_ad_network_fine_conversion_value.
- Menambahkan segments.sk_ad_network_redistributed_fine_conversion_value.
Metrik berikut kini ditampilkan dengan respons meskipun bernilai nol. Hal ini membuatnya konsisten dengan metrik lainnya.

Kriteria

Ditambahkan ke kolom berikut di AdGroupCriterion untuk menunjukkan apakah kriteria grup iklan ditayangkan atau alasan mengapa tidak ditayangkan:
- primary_status
- primary_status_reasons
Menambahkan dukungan untuk metrics.search_impression_share untuk gender_view
Menambahkan dukungan untuk metrics.phone_calls untuk keyword_view

Layanan Lokal

Menambahkan LocalServicesLeadService.AppendLeadConversation() yang digunakan untuk menambahkan LocalServicesLeadConversation baru ke LocalServicesLead, yang mengirim pesan kepada pengguna melalui saluran yang sesuai seperti SMS, bergantung pada cara prospek dibuat.
- Ukuran AppendLeadConversationRequest.conversations dibatasi maksimal 1.000.
- Hanya LocalServicesLead dengan lead_type yang ditetapkan ke LeadType.MESSAGE yang dapat ditentukan di Conversation.local_services_lead.
Menambahkan nilai enum baru ke ConversationType:
- WHATSAPP untuk merepresentasikan percakapan yang diperkenalkan melalui WhatsApp.
- ADS_API untuk mewakili percakapan yang diperkenalkan menggunakan metode LocalServicesLeadService.AppendLeadConversation() baru.
Menambahkan kolom baru berikut ke local_services_verification_artifact:
- local_services_verification_artifact.insurance_verification_artifact.expiration_date_time
- local_services_verification_artifact.license_verification_artifact.expiration_date_time

Pelaporan

Sekarang, Anda hanya dapat memilih kolom yang terkait dengan satu produk tertaut saat membuat kueri product_link. Memilih beberapa kolom dari beberapa produk tertaut akan menampilkan QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE. Misalnya, product_link.advertising_partner.customer dan product_link.data_partner.data_partner_id tidak dapat dipilih dalam kueri yang sama.
Meneruskan page_size ke GoogleAdsService.Search akan menghasilkan error RequestError.PAGE_SIZE_NOT_SUPPORTED.

Belanja

Menambahkan laporan baru shopping_product, yang sesuai dengan halaman Produk di UI Google Ads. Fitur ini mendukung pengembalian data terkait status produk saat ini dari akun Google Merchant Center yang ditautkan ke akun Google Ads.
- Anda dapat memfilter metrik dari laporan shopping_product menggunakan segments.date saat menggunakan GoogleAdsService.Search atau GoogleAdsService.SearchStream. Segmentasi menurut tanggal tidak diizinkan dan akan menampilkan error ShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION.

Sasaran Terpadu

Menambahkan UserListCustomerTypeService.MutateUserListCustomerTypes() untuk mengonfigurasi jenis pelanggan audiens.
CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings dihapus. Untuk mengonfigurasi setelan audiens sasaran siklus proses pelanggan, gunakan UserListCustomerTypeService.MutateUserListCustomerTypes().
- Lampirkan atau lepaskan daftar pengguna dengan menetapkan UserListCustomerType.customer_type_category ke UserListCustomerTypeCategory.PURCHASERS untuk menyertakannya ke dalam atau mengecualikannya dari definisi pelanggan yang ada untuk sasaran siklus proses pelanggan. Buka membuat segmen audiens untuk mengetahui detail selengkapnya.

Video

Menambahkan nilai berikut ke ContentLabelType. Anda dapat mengecualikan ContentLabelTypes ini di tingkat pelanggan:
- BRAND_SUITABILITY_CONTENT_FOR_FAMILIES
- BRAND_SUITABILITY_GAMES_FIGHTING
- BRAND_SUITABILITY_GAMES_MATURE
- BRAND_SUITABILITY_HEALTH_SENSITIVE
- BRAND_SUITABILITY_HEALTH_SOURCE_UNDETERMINED
- BRAND_SUITABILITY_NEWS_RECENT
- BRAND_SUITABILITY_NEWS_SENSITIVE
- BRAND_SUITABILITY_NEWS_SOURCE_NOT_FEATURED
- BRAND_SUITABILITY_POLITICS
- BRAND_SUITABILITY_RELIGION
Menambahkan AdVideoAsset.ad_video_asset_info untuk mendukung preferensi inventaris untuk aset video saat membuat DemandGenVideoResponsiveAdInfo.
(Khusus akun yang diizinkan) Membuat Campaign.video_brand_safety_suitability dapat diubah.

Arsip catatan rilis

Lihat Versi yang dihentikan untuk catatan rilis yang diarsipkan.