Halaman ini menyediakan catatan rilis untuk kampanye Display & Video 360 API.
Versi API terbaru: v3
15 Agustus 2024
Fitur Baru
Menambahkan dukungan untuk jenis Exchange
Netflix.
v3
Nilai enum berikut telah ditambahkan:
Enum Nilai Bursa EXCHANGE_NETFLIX
v2
Nilai enum berikut telah ditambahkan:
Enum Nilai Bursa EXCHANGE_NETFLIX
15 Juli 2024
Fitur Baru
Menambahkan dukungan untuk mendownload Item Baris dan File Data Terstruktur Grup Iklan di Format QA di v3.
v3
Kolom berikut telah ditambahkan:
Resource Kolom IdFilter Nilai enum berikut telah ditambahkan:
Enum Nilai FileType FILE_TYPE_AD_GROUP_QA
FILE_TYPE_LINE_ITEM_QA
17 Juni 2024
Fitur Baru
Menambahkan dukungan untuk mengelola penargetan kata kunci yang ditetapkan di tingkat pengiklan.
Menambahkan kolom optimizationObjective
baru ke pesanan pemasangan iklan
resource Anda optimizationObjective
hanya tersedia untuk pelanggan yang diizinkan.
v3
Kolom berikut telah ditambahkan:
Resource Kolom InsertionOrder Metode berikut kini mendukung jenis penargetan berikut:
Jenis Penargetan Metode TARGETING_TYPE_KEYWORD advertisers.editAssignedTargetingOptions
advertisers.listAssignedTargetingOptions
advertisers.targetingType.assignedTargetingOptions.create
advertisers.targetingType.assignedTargetingOptions.delete
v2
Metode berikut kini mendukung jenis penargetan berikut:
Jenis Penargetan Metode TARGETING_TYPE_KEYWORD advertisers.editAssignedTargetingOptions
advertisers.listAssignedTargetingOptions
advertisers.targetingType.assignedTargetingOptions.create
advertisers.targetingType.assignedTargetingOptions.delete
30 Mei 2024
Fitur Baru
Penambahan dukungan untuk File Data Terstruktur (SDF) versi 7.1.
v3
Nilai enum berikut telah ditambahkan:
Enum Nilai SdfVersion SDF_VERSION_7_1
v2
Nilai enum berikut telah ditambahkan:
Enum Nilai SdfVersion SDF_VERSION_7_1
23 April 2024
Fitur Baru
Menambahkan dukungan untuk jenis KPI, bursa, dan platform aplikasi yang baru.
v3
Kolom berikut telah ditambahkan:
Resource Kolom Kpi Nilai enum berikut telah ditambahkan:
Enum Nilai AppPlatform APP_PLATFORM_LG_TV
APP_PLATFORM_VIZIO_TV
Bursa EXCHANGE_DRAX
KpiType KPI_TYPE_CPCL
KPI_TYPE_CPCV
KPI_TYPE_CPV
KPI_TYPE_CUSTOM_IMPRESSION_VALUE_OVER_COST
KPI_TYPE_MAXIMIZE_PACING
KPI_TYPE_TOS10
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM
v2
Nilai enum berikut telah ditambahkan:
Enum Nilai AppPlatform APP_PLATFORM_LG_TV
APP_PLATFORM_VIZIO_TV
Bursa EXCHANGE_DRAX
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM
28 Februari 2024
Fitur Baru
Menambahkan kemampuan untuk secara eksplisit menghapus anggota dari audiens Customer Match.
Menambahkan dukungan untuk menargetkan bursa baru.
v3
Kolom berikut telah ditambahkan:
Resource Kolom firstAndThirdPartyAudiences.editCustomerMatchMembers Nilai enum berikut telah ditambahkan:
Enum Nilai Bursa EXCHANGE_ADMOST_GBID
EXCHANGE_APPLOVIN_GBID
EXCHANGE_CHARTBOOST_GBID
EXCHANGE_FYBER_GBID
EXCHANGE_TOPON_GBID
EXCHANGE_UNITY_GBID
v2
Kolom berikut telah ditambahkan:
Resource Kolom firstAndThirdPartyAudiences.editCustomerMatchMembers Nilai enum berikut telah ditambahkan:
Enum Nilai Bursa EXCHANGE_ADMOST_GBID
EXCHANGE_APPLOVIN_GBID
EXCHANGE_CHARTBOOST_GBID
EXCHANGE_FYBER_GBID
EXCHANGE_TOPON_GBID
EXCHANGE_UNITY_GBID
29 Januari 2024
Fitur Baru
Menambahkan kemampuan untuk mengambil aktivitas Floodlight melalui
Layanan floodlightGroups.floodlightActivities
.
Menambahkan kolom baru yang menginformasikan apakah YouTube & Item baris Partners menyertakan inventaris Google TV dalam penargetannya.
Menambahkan kolom baru untuk menyampaikan waktu login terakhir untuk Display & Video 360 .
v3
Metode berikut telah ditambahkan:
Layanan Metode floodlightGroups.floodlightActivities Kolom berikut telah ditambahkan:
Resource Kolom Pengguna YoutubeAndPartnersInventorySourceConfig
v2
Metode berikut telah ditambahkan:
Layanan Metode floodlightGroups.floodlightActivities Kolom berikut telah ditambahkan:
Resource Kolom Pengguna YoutubeAndPartnersInventorySourceConfig
14 November 2023
Fitur Baru
Menambahkan dukungan untuk meneruskan izin pengguna akhir saat mengupload Customer Match anggota audiens dalam semua versi aktif.
v3
Kolom berikut telah ditambahkan:
Resource Kolom ContactInfoList MobileDeviceIdList
v2
Kolom berikut telah ditambahkan:
Resource Kolom ContactInfoList MobileDeviceIdList
31 Oktober 2023
Fitur Baru
Memindahkan v3 dari beta publik dan ke ketersediaan umum.
Mengganti nama nilai enum AdGroupFormat
di v3 agar lebih akurat
mencerminkan format yang relevan.
Menambahkan dukungan untuk File Data Terstruktur v7 dengan penambahan
Nilai enum SDF_VERSION_7
di v2 dan v3.
v3
Nilai enum berikut telah dihapus:
Enum Nilai AdGroupFormat AD_GROUP_FORMAT_ACTION
Nilai enum berikut telah ditambahkan:
Enum Nilai AdGroupFormat AD_GROUP_FORMAT_RESPONSIVE
SdfVersion SDF_VERSION_7
v2
Nilai enum berikut telah ditambahkan:
Enum Nilai SdfVersion SDF_VERSION_7
2 Oktober 2023
Fitur Baru
Dirilis v3 dalam versi beta publik, yang mencakup perubahan berikut:
- Kemampuan untuk sepenuhnya mengelola daftar lokasi kedekatan, yang memungkinkan penggunaan
advertisers.locationLists.assignedLocations
layanan yang akan dibuat dan hapus lokasi yang ditetapkan keTARGETING_LOCATION_TYPE_PROXIMITY
ReferensiLocationList
. - Kolom boolean
enableOptimizedTargeting
baru, yang menggantikan kolomtargetingExpansionLevel
diTargetingExpansionConfig
. - Persyaratan kolom
billingConfig
di ResourceAdvertiser
, yang harus disertakan saat membuat Permintaanadvertisers.create
, dan KolombillingConfig
diPartner
resource Anda - Resource
AdGroup
danAdGroupAd
baru yang mengganti resourceYoutubeAdGroup
danYoutubeAdGroupAd
di v2.
Ikuti langkah-langkah dalam panduan migrasi kami untuk bermigrasi dari v2 ke v3.
Menambahkan dukungan untuk 3 nilai LineItemType
baru, satu nilai baru
YoutubeAndPartnersBiddingStrategyType
, dan satu
PartnerCostType
di v2 dan v3.
v3
Metode berikut telah ditambahkan:
Layanan Metode advertisers.adGroupAds advertisers.adGroups advertisers.adGroups.targetingTypes.assignedTargetingOptions customBiddingAlgorithms customBiddingAlgorithms.rules Metode berikut telah dihapus:
Layanan Metode advertisers.manualTriggers aktifkan
create
nonaktifkan
get
list
patch
advertisers.youtubeAdGroupAds get
list
advertisers.youtubeAdGroups bulkListAdGroupAssignedTargetingOptions
get
list
advertiser.youtubeAdGroups.targetingTypes.assignedTargetingOptions get
list
Perilaku metode berikut telah berubah:
Metode Perubahan advertisers.locationLists.create Sekarang mendukung pembuatan resource TARGETING_LOCATION_TYPE_PROXIMITY
LocationList
.advertisers.locationLists.patch Sekarang mendukung update TARGETING_LOCATION_TYPE_PROXIMITY
resourceLocationList
.advertisers.locationLists.assignedLocations.bulkEdit Kini mendukung pengeditan massal resource AssignedLocation
di resourceTARGETING_LOCATION_TYPE_PROXIMITY
LocationList
.advertisers.locationLists.assignedLocations.create Sekarang mendukung pembuatan resource AssignedLocation
di resourceTARGETING_LOCATION_TYPE_PROXIMITY
LocationList
.Parameter kueri berikut telah ditambahkan:
Metode Parameter inventorySources.get Kolom berikut telah diisi:
Resource Kolom Pengiklan Kolom berikut telah ditambahkan:
Resource Kolom BiddingStrategy InsertionOrder Partner TargetingExpansionConfig YoutubeAndPartnersSettings YoutubeAndPartnersInventorySourceConfig Kolom berikut telah dihapus:
Resource Kolom InsertionOrder performanceGoal
billableOutcome
TargetingExpansionConfig excludeFirstPartyAudience
targetingExpansionLevel
YoutubeAndPartnersSettings biddingStrategy
thirdPartyMeasurementSettings
YoutubeAndPartnersInventorySourceConfig includeYoutubeSearch
includeYoutubeVideos
Nilai enum berikut telah ditambahkan:
Enum Nilai CustomBiddingAlgorithmType RULE_BASED
LineItemType LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME
LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW
PartnerCostType PARTNER_COST_TYPE_SCIBIDS_FEE
ReadinessState READINESS_STATE_EVALUATION_FAILURE
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV
Nilai enum berikut telah dihapus:
Enum Nilai LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
v2
Nilai enum berikut telah ditambahkan:
Enum Nilai LineItemType LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME
LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW
PartnerCostType PARTNER_COST_TYPE_SCIBIDS_FEE
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV
25 Agustus 2023
Fitur Baru
Menambahkan dukungan untuk dua bursa dan dua YouTube & Mitra jenis strategi bidding.
Menambahkan kolom effectiveContentCategory
baru ke YouTube &
Mitra item baris untuk menampilkan
YoutubeAndPartnersContentCategory
digunakan oleh item baris saat
mempertimbangkan nilai yang ditetapkan di tingkat pengiklan dan item baris.
v2
Kolom berikut telah ditambahkan:
Resource Kolom YoutubeAndPartnersSettings Kolom berikut telah dihapus:
Resource Kolom InventorySource subSitePropertyId
Nilai enum berikut telah ditambahkan:
Enum Nilai Bursa EXCHANGE_HIVESTACK
EXCHANGE_RESET_DIGITAL
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS
5 Juni 2023
Fitur Baru
Menambahkan nilai SdfVersion
baru untuk File Data Terstruktur
(SDF) v6 di v1 dan v2.
v2
Nilai enum berikut telah ditambahkan:
Enum Nilai SdfVersion SDF_VERSION_6
v1
Nilai enum berikut telah ditambahkan:
Enum Nilai SdfVersion SDF_VERSION_6
9 Maret 2023
Fitur Baru
Menambahkan nilai LineItemWarningMessage
baru yang akan
ditetapkan ke kolom warningMessages
item baris jika memiliki
kolom excludeFirstPartyAudience
yang tidak digunakan lagi disetel ke
true
. Kolom excludeFirstPartyAudience
akan dihentikan
dan ditetapkan ke false
setelah 25 Maret 2023.
v2
Nilai enum berikut telah ditambahkan:
Enum Nilai LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
v1
Nilai enum berikut telah ditambahkan:
Enum Nilai LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
8 Februari 2023
Fitur Baru
Menambahkan kemampuan untuk mengambil YouTubeAdGroup
dan
Referensi YouTubeAdGroupAd
, serta Grup Iklan YouTube
penargetan resource. Selain itu, kami juga telah menambahkan
jenis penargetan yang dapat diambil yang digunakan di Grup Iklan YouTube
level organisasi. Baca halaman panduan baru kami tentang mengambil YouTube & Mitra
Referensi untuk informasi selengkapnya.
Penambahan dukungan untuk empat bursa tambahan di v1 dan v2.
v2
Metode berikut telah ditambahkan:
Layanan Metode advertisers.youtubeAdGroupAds advertisers.youtubeAdGroups advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions Kolom berikut telah ditambahkan:
Layanan Metode AssignedTargetingOption YoutubeAndPartnersSettings Nilai enum berikut telah ditambahkan:
Enum Nilai Bursa EXCHANGE_APPLOVIN
EXCHANGE_CONNATIX
EXCHANGE_JCD
EXCHANGE_PLACE_EXCHANGE
LineItemType LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY
TargetingType TARGETING_TYPE_SESSION_POSITION
TARGETING_TYPE_YOUTUBE_CHANNEL
TARGETING_TYPE_YOUTUBE_VIDEO
v1
Nilai enum berikut telah ditambahkan:
Enum Nilai Bursa EXCHANGE_APPLOVIN
EXCHANGE_CONNATIX
EXCHANGE_JCD
EXCHANGE_PLACE_EXCHANGE
6 Desember 2022
Fitur Baru
Memindahkan v2 dari beta publik dan ke ketersediaan umum.
Menambahkan kolom assignedTargetingOptionIdAlias
baru ke
Resource AssignedTargetingOption
, yang dapat digunakan sebagai pengganti
assignedTargetingOptionId
saat mengambil dan menghapus penargetan.
Kolom ini hanya ditetapkan untuk opsi penargetan yang ditetapkan dari jenis penargetan yang
ditetapkan melalui enum. Nilai alias adalah nilai enum yang relevan sebagai string.
Menambahkan kolom billingConfig
baru ke
Resource Advertiser
.
Menambahkan dukungan untuk mengambil data YouTube & Mitra item baris over-the-top,
diidentifikasi oleh tiga nilai LineItemType
baru.
Meningkatkan ukuran halaman maksimum menjadi 200 untuk berbagai metode list
di v1 dan v2. Tujuan
ukuran halaman default tidak berubah.
v2
Kolom berikut telah ditambahkan:
Resource Kolom Pengiklan AssignedTargetingOption Nilai enum berikut telah ditambahkan:
Enum Nilai LineItemType LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP
Ukuran halaman maksimum telah ditingkatkan untuk metode daftar berikut:
v1
Ukuran halaman maksimum telah ditingkatkan untuk metode daftar berikut:
Masalah umum
Update ini memperbaiki masalah umum berikut di v2:
- Opsi penargetan yang ditetapkan untuk jenis penargetan yang ditetapkan menggunakan enum
nilai di v2 tidak dapat dihapus atau diambil
menggunakan
assignedTargetingOptionId
dan mengharapkan untuk menggunakan nilai enum. Dengan pembaruan ini, penargetan yang ditetapkan opsi dapat dihapus atau diambil menggunakanassignedTargetingOptionId
atau nilai enum, yang diidentifikasi oleh kolomassignedTargetingOptionIdAlias
baru di ReferensiAssignedTargetingOption
. - Permintaan item baris
bulkUpdate
tidak menggunakan dengan benar parameter permintaanadvertisersId
, yang menampilkan error. Dengan pembaruan ini, metode ini telah diperbaiki dan parameter permintaan telah diganti namanya dariadvertisersId
hinggaadvertiserId
.
27 Oktober 2022
Menambahkan kemampuan untuk menduplikasi item baris yang ada dalam induk
InsertionOrder
Memperkenalkan dukungan tulis yang menargetkan pesanan pemasangan iklan parsial untuk subkumpulan
jenis penargetan baru dengan tambahan create
dan
Metode delete
ke
advertisers.insertionOrders.targetingTypes.assignedTargetingOptions
layanan.
Fitur Baru
v2
Metode berikut telah ditambahkan:
Layanan Metode advertisers.insertionOrders.targetingTypes.assignedTargetingOptions advertisers.lineItems
v1
Tidak ada fitur baru yang ditambahkan ke v1.
20 September 2022
Dirilis v2 dalam versi beta publik, yang mencakup perubahan berikut:
- Kemampuan untuk mengambil data YouTube & Item baris partner dan penargetannya
setelan menggunakan metode
get
danlist
diadvertisers.lineItems
danadvertisers.lineItems.targetingTypes.assignedTargetingOptions
. - Dua metode penargetan massal baru di layanan
advertisers.lineItems
yang memungkinkan pengeditan dan pengambilan menetapkan penargetan di beberapa item baris dengan permintaan tunggal. - Metode
bulkUpdate
baru yang memungkinkan pengguna memperbaruientityStatus
dari beberapa item baris dalam satu permintaan. - Logika penargetan baru yang memerlukan
AssignedTargetingOption
resource subkumpulan jenis penargetan ditetapkan dan diambil menggunakan nilai enum, bukan ID opsi penargetan yang diambil menggunakan layanantargetingTypes.targetingOptions
.
Ikuti langkah-langkah dalam panduan migrasi kami untuk bermigrasi dari v1 ke v2.
Menambahkan dukungan untuk tiga bursa baru di v1.
Fitur Baru
v2
Berikut adalah daftar perubahan antara v1 dan v2:
Metode berikut telah ditambahkan di v2:
Layanan Metode advertisers.lineItems bulkEditAssignedTargetingOptions
Metode berikut telah dihapus di v2:
Layanan Metode advertisers.lineItems bulkEditLineItemAssignedTargetingOptions
bulkListLineItemAssignedTargetingOptions
Metode berikut telah diganti namanya di v2:
Layanan Nama Metode Lama Nama Metode Baru advertisers bulkEditAdvertiserAssignedTargetingOptions
bulkListAdvertiserAssignedTargetingOptions
advertisers.campaigns bulkListCampaignAssignedTargetingOptions listAssignedTargetingOptions advertisers.insertionOrders bulkListInsertionOrderAssignedTargetingOptions listAssignedTargetingOptions partner bulkEditPartnerAssignedTargetingOptions editAssignedTargetingOptions Referensi
AssignedTargetingOption
dari jenis penargetan berikut menggunakan enum untuk penetapan penargetan di v2. KolomassignedTargetingOptionId
untuk resourceAssignedTargetingOption
jenis penargetan ini juga telah diupdate di v2 untuk menggunakan versi string nilai enum:Jenis Penargetan Jenis Enum TARGETING_TYPE_AGE_RANGE AgeRange TARGETING_TYPE_CONTENT_INSTREAM_POSITION ContentInstreamPosition TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION ContentOutstreamPosition TARGETING_TYPE_DEVICE_TYPE DeviceType TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION ContentRatingTier TARGETING_TYPE_ENVIRONMENT Lingkungan TARGETING_TYPE_EXCHANGE Bursa TARGETING_TYPE_GENDER Gender TARGETING_TYPE_HOUSEHOLD_INCOME HouseholdIncome TARGETING_TYPE_NATIVE_CONTENT_POSITION NativeContentPosition TARGETING_TYPE_OMID Omid TARGETING_TYPE_PARENTAL_STATUS ParentalStatus TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION SensitiveCategory TARGETING_TYPE_VIDEO_PLAYER_SIZE VideoPlayerSize TARGETING_TYPE_VIEWABILITY Visibilitas Kolom berikut telah ditambahkan di v2:
Kolom berikut telah dihapus di v2:
Kolom berikut telah dibuat wajib di v2:
Nilai enum berikut telah ditambahkan di v2:
Enum Nilai AgeRange AGE_RANGE_18_20
AGE_RANGE_21_24
AGE_RANGE_25_29
AGE_RANGE_30_34
AGE_RANGE_35_39
AGE_RANGE_40_44
AGE_RANGE_45_49
AGE_RANGE_50_54
AGE_RANGE_55_59
AGE_RANGE_60_64
ContentRatingTier CONTENT_RATING_TIER_FAMILIES
Bursa EXCHANGE_DAX
EXCHANGE_FYBER
EXCHANGE_VISTAR
LineItemType LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE
ReservationType RESERVATION_TYPE_INSTANT_RESERVE
RESERVATION_TYPE_PETRA_VIRAL
SensitiveCategory SENSITIVE_CATEGORY_EMBEDDED_VIDEO
SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO
Nilai enum berikut telah dihapus di v2:
Enum Nilai LineItemFlightDateType LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER
LineItemWarningMessage APP_INSTALL_NO_CONVERSION_PIXEL
APP_INSTALL_NO_OPTIMAL_BIDDING_STRATEGY
CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS
NO_CREATIVE_FOR_TARGETED_DEALS
NO_POSITIVE_AUDIENCE_LIST_TARGETED
TARGETING_DEPRECATED_GEO_TARGET
TARGETING_REVOKED_OR_CLOSED_USER_LIST
v1
Nilai enum berikut telah ditambahkan di v1:
Enum Nilai Bursa EXCHANGE_DAX
EXCHANGE_FYBER
EXCHANGE_VISTAR
26 Mei 2022
Menambahkan kemampuan untuk membuat resource InventorySource
dan
mengelola resource GuaranteedOrder
melalui
inventorySources
metode penulisan layanan dan
guaranteedOrders
.
Memperkenalkan kolom modelReadiness
di
Resource CustomBiddingAlgorithm
. Kolom ini mencantumkan kesiapan model
model algoritme untuk setiap pengiklan yang dapat mengaksesnya.
Mengaktifkan fungsi parameter kueri filter
baru untuk
metode advertisers.creatives.list
yang memungkinkan pengguna
untuk hanya mengambil materi iklan dengan updateTime
sebelum atau setelah stempel waktu tertentu.
Penambahan dukungan untuk versi SDF terbaru, v5.5, melalui
penambahan nilai enum SdfVersion
.
Fitur Baru
Metode berikut telah ditambahkan:
Layanan Metode guaranteedOrders inventorySources Kolom berikut telah ditambahkan:
Resource Kolom CustomBiddingAlgorithm InventorySource Nilai enum berikut telah ditambahkan:
Enum Nilai SdfVersion Metode daftar berikut sekarang dapat difilter berdasarkan properti berikut:
Metode Kolom advertisers.creatives.list
31 Maret 2022
Menambahkan dukungan untuk mengambil dan menetapkan penargetan di durasi konten, jenis streaming, dan genre.
Menambahkan kolom billableOutcome
ke InsertionOrder
.
Memperkenalkan kolom raiseBidForDeals
ke
Objek MaximizeSpendBidStrategy
, yang memungkinkan pengguna menentukan apakah bidding
menerapkan harga minimum pengiklan untuk transaksi yang ditargetkan.
Fitur Baru
Kolom berikut telah ditambahkan:
Resource Kolom AssignedTargetingOption InsertionOrder MaximizeSpendBidStrategy TargetingOption Nilai enum berikut telah ditambahkan:
Enum Nilai TargetingType
2 Februari 2022
Penambahan dukungan untuk membuat, memperbarui, dan
mengedit anggota Customer Match tertentu
FirstAndThirdPartyAudience
. Tujuan
Upload Audiens Customer Match di halaman baru
Panduan Menggunakan Audiens menjelaskan cara menggunakan fitur baru ini.
Memperkenalkan kolom reservationType
baru di
InsertionOrder
dan LineItem
resource yang mengidentifikasi apakah resource merupakan Dijamin oleh Tag dan Terprogram
Dijamin, atau tidak dijamin.
Menambahkan kemampuan untuk mengambil dan menetapkan apakah item baris otomatis menargetkan
bursa baru melalui excludeNewExchanges
baru
kolom tersebut.
Selain fitur baru, batas kuota default telah digandakan.
Fitur Baru
Metode berikut telah ditambahkan:
Layanan Metode firstAndThirdPartyAudiences Kolom berikut telah ditambahkan:
Resource Kolom FirstAndThirdPartyAudience InsertionOrder ItemBaris
8 Desember 2021
Menambahkan dukungan untuk penargetan jenis konten audio di bagian jenis penargetan
TARGETING_TYPE_AUDIO_CONTENT_TYPE
Fitur Baru
Kolom berikut telah ditambahkan:
Resource Kolom AssignedTargetingOption TargetingOption Nilai enum berikut telah ditambahkan:
Enum Nilai TargetingType
8 November 2021
Menambahkan dukungan penuh untuk mengelola algoritma bidding kustom dan skripnya. Hal ini mencakup:
- Fungsi untuk membuat fungsi baru dan memperbarui yang ada
customBiddingAlgorithms
. - Kemampuan mengunggah skrip melalui proses mengambil lokasi resource yang tersedia, lalu mengupload file ke lokasi tersebut.
- Layanan
customBiddingAlgorithms.scripts
baru untuk ambil dan buatcustomBiddingScripts
.
Halaman Terapkan Bidding Kustom baru telah ditambahkan ke panduan Mengelola Item Baris yang menjelaskan pembuatan algoritma bidding kustom, mengupload skrip, dan menetapkan algoritma bidding kustom sebagai strategi bidding item baris.
Penambahan dukungan untuk versi SDF terbaru, v5.4, melalui
penambahan nilai enum SdfVersion
.
Fitur Baru
Metode berikut telah ditambahkan:
Layanan Metode customBiddingAlgorithms customBiddingAlgorithms.scripts media Nilai enum berikut telah ditambahkan:
Enum Nilai SdfVersion
14 September 2021
Menambahkan dukungan untuk penargetan kedekatan pada jenis penargetan
TARGETING_TYPE_BUSINESS_CHAIN
dan
TARGETING_TYPE_POI
.
Menambahkan kemampuan untuk menelusuri tersedia
TARGETING_TYPE_BUSINESS_CHAIN
dan
Opsi penargetan TARGETING_TYPE_POI
menggunakan
targetingTypes.targetingOptions.search
, karena tidak boleh
diambil melalui targetingTypes.targetingOptions.get
atau
targetingTypes.targetingOptions.list
metode.
Memperkenalkan sharedAdvertiserIds
baru dan
Kolom customBiddingAlgorithmState
ke Bidding Kustom
Resource algoritma dan dukungan tambahan untuk
Jenis algoritma bidding kustom GOAL_BUILDER_BASED
.
Menambahkan dua nilai baru ke enum Exchange
.
Fitur Baru
Kolom berikut telah ditambahkan:
Resource Kolom AssignedTargetingOption CustomBiddingAlgorithm TargetingOption Isi Permintaan PenargetanOptions.search Nilai enum berikut telah ditambahkan:
Enum Nilai CustomBiddingAlgorithmType Bursa TargetingType Metode daftar berikut sekarang dapat difilter berdasarkan properti berikut:
Metode Kolom customBiddingAlgorithms.list
4 Agustus 2021
Menambahkan dukungan untuk Pengukuran Terbuka diaktifkan
penargetan inventaris di bagian jenis penargetan
TARGETING_TYPE_OMID
Meningkatkan jumlah maksimum opsi penargetan yang ditetapkan yang dapat ditampilkan
di satu halaman yang berisi berbagai pengiklan, kampanye,
pesanan pemasangan iklan, dan item baris yang ditetapkan penargetan
daftar opsi menggunakan parameter metode pageSize
.
Fitur Baru
Kolom berikut telah ditambahkan:
Resource Kolom AssignedTargetingOption TargetingOption Nilai enum berikut telah ditambahkan:
Enum Nilai TargetingType Ukuran halaman maksimum telah ditingkatkan untuk metode daftar berikut:
26 Mei 2021
Meluncurkan layanan advertisers.invoices
, yang memungkinkan
pengguna:
- mengambil faktur yang dikeluarkan untuk pengiklan selama bulan tertentu.
- mencari kode mata uang yang digunakan oleh pengiklan selama bulan tertentu.
Menambahkan kolom campaignBudgets
ke kampanye
resource Anda Segmen anggaran pesanan pemasangan iklan dapat ditautkan ke
anggaran kampanye, yang membatasi jumlah anggaran
segmen terkait dengan total jumlah anggaran kampanye.
Menambahkan dukungan untuk
penargetan posisi konten native di bagian
jenis penargetan TARGETING_TYPE_NATIVE_CONTENT_POSITION
.
Memperkenalkan kolom prismaEnabled
baru kepada pengiklan
, yang memungkinkan pengguna mengaktifkan integrasi dengan alat Prisma dari Mediaocean.
Mengaktifkan dukungan untuk nilai enum ENTITY_STATUS_PAUSED
ke
Kolom entityStatus
pengiklan.
Fitur Baru
Metode berikut telah ditambahkan:
Layanan Metode advertisers.invoices Kolom berikut telah ditambahkan:
Resource Kolom Pengiklan AssignedTargetingOption TargetingOption Nilai enum berikut telah ditambahkan:
Enum Nilai AssignedTargetingOption.Recency Bursa TargetingType Nilai enum berikut sekarang valid untuk kolom berikut:
Resource Kolom Nilai Pengiklan entityStatus ENTITY_STATUS_PAUSED
29 April 2021
Menambahkan kolom baru ke Channel dan
Referensi Daftar Kata Kunci Negatif yang menampilkan jumlah baris
item yang menggunakan resource untuk penargetan. Mengaktifkan filter
baru
properti untuk metode daftar item baris yang memungkinkan pengguna
hanya mengambil item baris yang menggunakan saluran atau kata kunci negatif tertentu
daftar dalam penargetannya.
Fitur Baru
Kolom berikut telah ditambahkan:
Resource Kolom Kanal Metode daftar berikut sekarang dapat difilter berdasarkan properti berikut:
Metode Kolom advertisers.lineItems.list targetedChannelId
targetedNegativeKeywordListId
30 Maret 2021
Menambahkan metode baru ke layanan item baris yang membuat item baris dengan konfigurasi default. Nilai default ini didasarkan pada jenis item baris yang dipilih, serta setelan dan item penargetan pesanan pemasangan iklan induk.
Mengaktifkan pengambilan penargetan kampanye melalui layanan penargetan kampanye baru dan metode daftar massal tambahan.
Memperluas penargetan aplikasi untuk memungkinkan penargetan aplikasi di lebih banyak platform.
Membuat beberapa perubahan pada advertisers.channels.sites
,
partners.channels.sites
dan
advertisers.negativeKeywordLists.negativeKeywords
layanan ke
mempermudah pengelolaan saluran dan konten daftar kata kunci negatif. Ini
perubahan tersebut meliputi:
- Penambahan metode
replace
, yang memungkinkan pengguna menimpa sepenuhnya konten saluran atau daftar kata kunci negatif yang ada. - Penghapusan persyaratan yang tidak ada
item disertakan dalam
createdSites
ataucreatedNegativeKeywords
kolom pengeditan massal permintaan. - Peningkatan jumlah maksimum item yang dapat ditampilkan dalam satu item halaman situs daftar atau cantumkan kata kunci negatif.
Fitur Baru
Metode berikut telah ditambahkan:
Kolom berikut telah ditambahkan:
Resource Kolom AssignedTargetingOption.AppAssignedTargetingOptionDetails Ukuran halaman maksimum telah ditingkatkan untuk metode daftar berikut:
Metode Ukuran Halaman Maks Lama Ukuran Halaman Maks Baru advertisers.channels.sites.list 100 10000 advertisers.negativeKeywordLists.negativeKeywords.list 100 1000 partners.channels.sites.list 100 10000
Penghentian penggunaan
Nilai enum berikut tidak dapat lagi ditetapkan ke resource baru atau yang sudah ada:
Enum Nilai PartnerRevenueModelMarkupType PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP
24 Februari 2021
Memperkenalkan layanan penargetan pesanan pemasangan iklan baru dan metode daftar massal tambahan yang memungkinkan pengambilan penargetan yang ditetapkan ke pesanan pemasangan iklan. Memperluas sumber daya materi iklan, menambahkan kolom materi iklan khusus output untuk digunakan oleh materi iklan audio pihak ketiga. Menambahkan jenis sasaran performa baru untuk digunakan oleh pesanan pemasangan iklan dan kampanye Google Cloud Platform.
Fitur Baru
Metode berikut telah ditambahkan:
Layanan Metode advertisers.insertionOrders advertisers.insertionOrders.targetingTypes.assignedTargetingOptions Kolom berikut telah ditambahkan:
Resource Kolom Materi iklan Nilai enum berikut telah ditambahkan:
Enum Nilai ContentInstreamPosition PerformanceGoalType PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE
PERFORMANCE_GOAL_TYPE_CLICK_CVR
PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR
27 Januari 2021
Mengaktifkan pengambilan dan pengelolaan pesanan pemasangan iklan TV dan produk over-the-top
item melalui pengenalan
kolom InsertOrderType baru dan
nilai enum LineItemType baru. Menambahkan dukungan untuk aplikasi seluler
item baris melalui kolom item baris mobileApp
.
Perluasan bursa, audiens Google, dan
Dukungan SDF melalui nilai enum tambahan. Memperkenalkan
kemampuan untuk memfilter dan mengurutkan advertisers.list
nilai berdasarkan waktu terakhir diperbarui.
Fitur Baru
Kolom berikut telah ditambahkan:
Resource Kolom InsertionOrder LineItem Nilai enum berikut telah ditambahkan:
Enum Nilai Bursa GoogleAudienceType LineItemType SdfVersion Metode daftar berikut kini dapat diurutkan dan difilter menurut kolom berikut:
Metode Kolom pengiklan
4 Desember 2020
Menambahkan kemampuan untuk menelusuri Opsi penargetan Wilayah Geografis dan memfilter beberapa resource daftar hasil metode menurut waktu pembaruan terakhirnya. Memperkenalkan LineItemWarningMessage baru untuk memberi tahu pengguna saat item baris menggunakan penargetan geografis yang tidak digunakan lagi.
Fitur Baru
Metode berikut telah ditambahkan:
Layanan Metode targetingTypes.targetingOptions Nilai enum berikut telah ditambahkan:
Enum Nilai Bursa LineItemWarningMessage Metode daftar berikut kini dapat diurutkan dan difilter menurut kolom berikut:
Metode Kolom advertisers.campaigns.list advertisers.insertionOrders.list advertisers.lineItems.list
5 November 2020
Menambahkan kemampuan untuk membuat, menetapkan, dan mengaktifkan pemicu manual yang memulai item baris terkait pengeluaran Google Cloud Anda. Memperkenalkan opsi perluasan penargetan yang, jika ditetapkan, dapat memperluas penargetan item baris untuk menyertakan pengguna yang mirip dengan mereka yang berada di target audiens. Menambahkan kolom ID segmen kustom ke DoubleVerify dan Integral Ad Science objek yang digunakan dalam penargetan verifikasi pihak ketiga.
Fitur Baru
Layanan berikut telah ditambahkan:
Layanan Metode advertisers.manualTriggers Kolom berikut telah ditambahkan:
Resource Kolom AssignedTargetingOption.DoubleVerify AssignedTargetingOption.IntegralAdScience LineItem LineItemFlight Nilai enum berikut telah ditambahkan:
Enum Nilai LineItemFlightDateType Metode daftar berikut kini dapat difilter menurut kolom berikut:
Metode Kolom advertisers.lineItems.list
12 Oktober 2020
Memperkenalkan pesan peringatan yang dapat diambil ke item baris
dan jenis sasaran performa rasio klik-tayang (CTR). Ditambahkan
warningMessages
sebagai kolom yang dapat difilter saat mencantumkan item baris.
Selain fitur baru, batas kuota baru kini diberlakukan dan tersedia dokumentasi baru tentang menggunakan permintaan batch.
Fitur Baru
Kolom berikut telah ditambahkan:
Resource Kolom LineItem Nilai enum berikut telah ditambahkan:
Enum Nilai PerformanceGoalType Metode daftar berikut kini dapat difilter menurut kolom berikut:
Metode Kolom advertisers.lineItems.list
28 Agustus 2020
Menambahkan kolom baru ke respons metode audit pengiklan dan kolom baru yang dapat difilter ke berbagai metode daftar.
Fitur Baru
Kolom berikut telah ditambahkan:
Resource Kolom Isi Respons Pengiklan.Audit Metode daftar berikut kini dapat difilter menurut kolom berikut:
Metode Kolom advertisers.list advertisers.campaigns.list advertisers.insertionOrders.list advertisers.lineItems.list targetingTypes.targetingOptions.list
4 Agustus 2020
Meluncurkan layanan pengelolaan pengguna, partner, dan layanan penargetan partner baru. Memperkenalkan alat untuk membantu pengguna secara proaktif agar tidak mencapai batas entitas akun. Menambahkan dukungan untuk item baris audio dan penggunaan algoritma bidding kustom dalam strategi bidding item baris dan pesanan pemasangan iklan.
Fitur Baru
Layanan berikut telah ditambahkan:
Layanan Metode customBiddingAlgorithms partner partners.targetingTypes.assignedTargetingOptions pengguna Metode berikut telah ditambahkan:
Layanan Metode pengiklan Kolom berikut telah ditambahkan:
Resource Kolom MaximizeSpendBidStrategy PerformanceGoalBidStrategy Nilai enum berikut telah ditambahkan:
Enum Nilai BiddingStrategyPerformanceGoalType LineItemType Metode daftar berikut kini dapat diurutkan dan difilter menurut kolom berikut:
Metode Kolom advertisers.lineItems.list Cakupan berikut telah ditambahkan untuk digunakan pada layanan berikut:
Cakupan Layanan https://www.googleapis.com/auth/display-video-user-management
24 Juni 2020
Meluncurkan update kecil dengan menambahkan metode buat untuk channel partner dan pengiklan, kolom FirstAndThirdPartyAudience baru, dan nilai enum bursa tambahan.
Fitur Baru
Layanan berikut telah ditambahkan:
Layanan Metode advertisers.channels partners.channels Kolom berikut telah ditambahkan:
Resource Kolom FirstAndThirdPartyAudience Nilai enum berikut telah ditambahkan:
Enum Nilai Bursa Metode daftar berikut kini dapat difilter menurut kolom berikut:
Metode Kolom advertisers.creatives.list
2 Juni 2020
Memperkenalkan kemampuan untuk membuat, menerapkan patch, dan mengisi subkumpulan entitas yang dapat ditargetkan serta menambahkan kemampuan untuk mengubah penargetan tingkat pengiklan untuk tiga jenis penargetan: saluran, pengecualian label konten digital, dan pengecualian kategori sensitif.
Fitur Baru
Layanan berikut telah ditambahkan:
Metode berikut telah ditambahkan:
Layanan Metode pengiklan advertisers.channels advertisers.locationLists advertisers.negativeKeywordLists inventorySourceGroups partners.channels Kolom berikut telah ditambahkan:
Resource Kolom pengiklan materi iklan insertionOrder.insertionOrderBudgetSegment
27 April 2020
Meluncurkan set fitur yang besar, yang memperluas cakupan API di luar SDF. Ditambahkan pengelolaan aset inti yang memungkinkan Anda membuat, mengambil, memperbarui, dan menghapus entitas seperti pengiklan, kampanye, pesanan pemasangan iklan, item baris, dan materi iklan. Kemampuan baru juga memungkinkan pengeditan penargetan di tingkat item baris.
Fitur Baru
Layanan berikut telah ditambahkan:
9 Maret 2020
Meluncurkan Display & Video 360 API v1. Ini adalah versi awal API.
Masalah umum
Tidak ada.