Halaman ini menyediakan catatan rilis untuk Display & Video 360 API.
Versi API terbaru: v3
23 April 2024
Fitur Baru
Menambahkan dukungan untuk jenis KPI, bursa, dan platform aplikasi 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 menghapus anggota secara eksplisit 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
baru.
Menambahkan kolom baru yang memberitahukan apakah item baris YouTube & Partners menyertakan inventaris Google TV dalam penargetannya.
Menambahkan kolom baru untuk meneruskan waktu login terakhir untuk pengguna 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 anggota audiens Customer Match 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 ke ketersediaan umum.
Mengganti nama nilai enum AdGroupFormat
di v3 untuk mencerminkan
format yang relevan dengan lebih akurat.
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, sehingga memungkinkan penggunaan layanan
advertisers.locationLists.assignedLocations
untuk membuat dan menghapus lokasi yang ditetapkan ke resourceTARGETING_LOCATION_TYPE_PROXIMITY
LocationList
. - Kolom
enableOptimizedTargeting
boolean baru, yang menggantikan kolomtargetingExpansionLevel
di objekTargetingExpansionConfig
. - Persyaratan kolom
billingConfig
di resourceAdvertiser
, yang harus disertakan saat membuat permintaanadvertisers.create
, dan kolombillingConfig
baru di resourcePartner
. - Resource
AdGroup
danAdGroupAd
baru yang menggantikan resourceYoutubeAdGroup
danYoutubeAdGroupAd
di v2.
Ikuti langkah-langkah dalam panduan migrasi untuk bermigrasi dari v2 ke v3.
Menambahkan dukungan untuk 3 nilai LineItemType
baru, satu
YoutubeAndPartnersBiddingStrategyType
baru, dan satu
PartnerCostType
baru 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 Kini 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
dalam 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 jenis strategi bidding YouTube & Partner baru.
Menambahkan kolom effectiveContentCategory
baru ke item baris YouTube &
Partners untuk menampilkan
YoutubeAndPartnersContentCategory
yang 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
kolom excludeFirstPartyAudience
yang tidak digunakan lagi ditetapkan 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 resource YouTubeAdGroup
dan
YouTubeAdGroupAd
, serta penargetan resource
Grup Iklan YouTube. Selain itu, kami juga telah menambahkan
jenis penargetan baru yang dapat diambil dan digunakan di tingkat Grup Iklan
YouTube. Baca halaman panduan baru kami tentang cara mengambil resource YouTube & Partner untuk mengetahui informasi lebih lanjut.
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 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 item baris over-the-top YouTube & Partner,
yang diidentifikasi oleh tiga nilai LineItemType
baru.
Ukuran halaman maksimum ditingkatkan menjadi 200 untuk berbagai metode list
di v1 dan v2. 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 nilai
enumerasi di v2 tidak dapat dihapus atau diambil
menggunakan
assignedTargetingOptionId
dan justru mengharapkan pengguna menggunakan nilai enum. Dengan pembaruan ini, opsi penargetan yang ditetapkan ini dapat dihapus atau diambil menggunakanassignedTargetingOptionId
atau nilai enum, yang diidentifikasi oleh kolomassignedTargetingOptionIdAlias
baru di resourceAssignedTargetingOption
. - Permintaan
bulkUpdate
item baris tidak menggunakan parameter permintaanadvertisersId
dengan benar, sehingga menampilkan error. Dengan update ini, metode tersebut telah diperbaiki dan parameter permintaan telah diganti namanya dariadvertisersId
menjadiadvertiserId
.
27 Oktober 2022
Menambahkan kemampuan untuk menduplikasi item baris yang ada dalam induk
InsertionOrder
.
Memperkenalkan dukungan tulis yang menargetkan pesanan pemasangan iklan sebagian untuk sebagian
jenis penargetan dengan penambahan metode create
dan
delete
ke
layanan
advertisers.insertionOrders.targetingTypes.assignedTargetingOptions
.
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 beta publik, yang mencakup perubahan berikut:
- Kemampuan untuk mengambil item baris YouTube & Partners dan setelan penargetannya
menggunakan metode
get
danlist
di layananadvertisers.lineItems
danadvertisers.lineItems.targetingTypes.assignedTargetingOptions
. - Dua metode penargetan massal baru di layanan
advertisers.lineItems
yang memungkinkan pengeditan dan pengambilan penargetan yang ditetapkan di beberapa item baris dengan satu permintaan. - Metode
bulkUpdate
baru yang memungkinkan pengguna memperbaruientityStatus
beberapa item baris dalam satu permintaan. - Logika penargetan baru yang mengharuskan resource
AssignedTargetingOption
dari subkumpulan jenis penargetan untuk ditetapkan dan diambil menggunakan nilai enum, bukan ID opsi penargetan yang diambil menggunakan layanantargetingTypes.targetingOptions
.
Ikuti langkah-langkah dalam panduan migrasi 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 partners bulkEditPartnerAssignedTargetingOptions editAssignedTargetingOptions Referensi
AssignedTargetingOption
dari jenis penargetan berikut menggunakan enum untuk menargetkan penetapan di v2. KolomassignedTargetingOptionId
untuk resourceAssignedTargetingOption
jenis penargetan ini juga telah diperbarui di v2 untuk menggunakan versi string dari 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 wajib diisi 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 metode penulisan layanan
inventorySources
baru dan layanan
guaranteedOrders
baru.
Memperkenalkan kolom modelReadiness
di resource
CustomBiddingAlgorithm
. Kolom ini mencantumkan kesiapan model algoritma untuk setiap pengiklan yang dapat mengaksesnya.
Mengaktifkan fungsi parameter kueri filter
baru untuk
metode advertisers.creatives.list
yang memungkinkan pengguna
hanya mengambil materi iklan dengan updateTime
sebelum atau setelah stempel waktu tertentu.
Menambahkan 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 kini dapat difilter berdasarkan properti berikut:
Metode Kolom advertisers.creatives.list
31 Maret 2022
Menambahkan dukungan untuk mengambil dan menetapkan penargetan pada durasi konten, jenis streaming, dan genre.
Menambahkan kolom billableOutcome
ke objek
InsertionOrder
.
Memperkenalkan kolom raiseBidForDeals
ke
objek MaximizeSpendBidStrategy
, yang memungkinkan pengguna menetapkan apakah strategi
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
Menambahkan dukungan untuk membuat, memperbarui, dan
mengedit anggota resource FirstAndThirdPartyAudience
Customer Match
tertentu. Halaman
Upload Audiens Customer Match di panduan
Gunakan Audiens baru menjelaskan cara menggunakan fitur baru ini.
Memperkenalkan kolom reservationType
baru di resource
InsertionOrder
dan LineItem
yang mengidentifikasi apakah resource berstatus Dijamin oleh Tag, Dijamin Terprogram, atau tidak dijamin.
Menambahkan kemampuan untuk mengambil dan menetapkan apakah item baris otomatis menargetkan
pertukaran baru melalui kolom excludeNewExchanges
baru.
Selain fitur baru, batas kuota default telah ditingkatkan dua kali lipat.
Fitur Baru
Metode berikut telah ditambahkan:
Layanan Metode firstAndThirdPartyAudiences Kolom berikut telah ditambahkan:
Resource Kolom FirstAndThirdPartyAudience InsertionOrder LineItem
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
Penambahan dukungan penuh untuk mengelola algoritma bidding kustom dan skripnya. Hal ini mencakup:
- Fungsi untuk membuat
customBiddingAlgorithms
yang baru dan memperbarui yang sudah ada. - Kemampuan untuk mengupload skrip melalui proses mengambil lokasi resource yang tersedia, lalu mengupload file ke lokasi tersebut.
- Layanan
customBiddingAlgorithms.scripts
baru untuk mengambil dan membuatcustomBiddingScripts
.
Halaman Terapkan Bidding Kustom baru telah ditambahkan ke panduan Mengelola Item Baris kami yang menjelaskan proses pembuatan algoritma bidding kustom, mengupload skrip, dan menetapkan algoritma bidding kustom sebagai strategi bidding item baris.
Menambahkan 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 jarak di bagian jenis penargetan
TARGETING_TYPE_BUSINESS_CHAIN
dan
TARGETING_TYPE_POI
.
Menambahkan kemampuan untuk menelusuri opsi penargetan
TARGETING_TYPE_BUSINESS_CHAIN
dan
TARGETING_TYPE_POI
yang tersedia menggunakan
targetingTypes.targetingOptions.search
, karena opsi tersebut tidak dapat
diambil melalui metode targetingTypes.targetingOptions.get
atau
targetingTypes.targetingOptions.list
.
Memperkenalkan kolom sharedAdvertiserIds
dan
customBiddingAlgorithmState
baru ke resource Algoritma Bidding
Kustom dan menambahkan dukungan 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 kini dapat difilter berdasarkan properti berikut:
Metode Kolom customBiddingAlgorithms.list
4 Agustus 2021
Menambahkan dukungan untuk penargetan inventaris yang mengaktifkan
Pengukuran Terbuka di bagian jenis penargetan
TARGETING_TYPE_OMID
.
Meningkatkan jumlah maksimum opsi penargetan yang ditetapkan yang dapat ditampilkan
di satu halaman dari berbagai metode daftar opsi penargetan
yang ditetapkan menggunakan parameter metode pageSize
,
yaitu pengiklan, kampanye,
pesanan pemasangan iklan, dan item baris.
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 invoice yang dikeluarkan untuk pengiklan selama bulan tertentu.
- mencari kode mata uang yang digunakan oleh pengiklan selama bulan tertentu.
Menambahkan kolom campaignBudgets
ke resource
kampanye. Segmen anggaran pesanan pemasangan iklan dapat ditautkan ke
anggaran kampanye, sehingga membatasi jumlah anggaran
segmen terkait hingga total jumlah anggaran kampanye.
Menambahkan dukungan untuk
penargetan posisi konten native di bagian jenis penargetan
baru TARGETING_TYPE_NATIVE_CONTENT_POSITION
.
Memperkenalkan kolom prismaEnabled
baru ke resource
pengiklan, yang memungkinkan pengguna mengaktifkan integrasi dengan alat Prisma 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 Field Nilai Pengiklan entityStatus ENTITY_STATUS_PAUSED
29 April 2021
Menambahkan kolom baru ke resource Saluran dan
Daftar Kata Kunci Negatif yang menampilkan jumlah item baris
menggunakan resource untuk penargetan. Mengaktifkan properti filter
baru untuk metode daftar item baris yang memungkinkan pengguna
hanya mengambil item baris yang menggunakan saluran atau daftar kata kunci negatif
tertentu dalam penargetannya.
Fitur Baru
Kolom berikut telah ditambahkan:
Resource Kolom Kanal Metode daftar berikut kini dapat difilter berdasarkan properti berikut:
Metode Kolom advertisers.lineItems.list targetedChannelId
targetedNegativeKeywordListId
30 Maret 2021
Menambahkan metode baru ke layanan item baris yang menghasilkan item baris dengan konfigurasi default. Nilai default ini didasarkan pada jenis item baris yang ditentukan, serta setelan dan penargetan urutan 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 layanan advertisers.channels.sites
,
partners.channels.sites
, dan
advertisers.negativeKeywordLists.negativeKeywords
agar
pengelolaan konten saluran dan daftar kata kunci negatif lebih mudah. Perubahan
ini mencakup:
- Penambahan metode
replace
, yang memungkinkan pengguna menimpa sepenuhnya konten saluran atau daftar kata kunci negatif yang ada. - Penghapusan persyaratan bahwa tidak ada item
yang ada yang disertakan dalam kolom
createdSites
ataucreatedNegativeKeywords
dari permintaan edit massal. - Peningkatan jumlah maksimum item yang dapat ditampilkan di satu halaman respons situs daftar atau respons daftar 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 1.000 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 resource materi iklan, dengan menambahkan kolom materi iklan khusus output untuk digunakan oleh materi iklan audio pihak ketiga. Menambahkan jenis sasaran performa baru untuk digunakan melalui resource pesanan pemasangan iklan dan kampanye.
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 item baris over-the-top
melalui pengenalan
kolom penyisipanOrderType baru dan
nilai enum LineItemType baru. Menambahkan dukungan untuk item baris
aplikasi seluler melalui kolom item baris mobileApp
.
Perluasan dukungan bursa, audiens google, dan
SDF melalui nilai enum tambahan. Memperkenalkan
kemampuan untuk memfilter dan mengurutkan nilai advertisers.list
menurut 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
Penambahan kemampuan untuk menelusuri opsi penargetan Wilayah Geo dan memfilter beberapa hasil metode daftar resource berdasarkan waktu terakhirnya diperbarui. 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 pengeluaran item baris terkait. Memperkenalkan opsi perluasan penargetan yang, jika ditetapkan, dapat memperluas penargetan item baris untuk menyertakan pengguna yang serupa dengan pengguna di target audiens. Menambahkan kolom ID segmen kustom ke objek DoubleVerify dan Integral Ad Science 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 berdasarkan kolom berikut:
Metode Kolom advertisers.lineItems.list
12 Oktober 2020
Memperkenalkan pesan peringatan yang dapat diambil kembali ke resource item baris
dan jenis sasaran performa rasio klik-tayang (CTR). Menambahkan
warningMessages
sebagai kolom yang dapat difilter saat mencantumkan item baris.
Selain fitur baru, batas kuota baru sekarang telah berlaku dan tersedia dokumentasi baru tentang penggunaan 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 berdasarkan 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 Audit.Pengiklan Metode daftar berikut kini dapat difilter berdasarkan 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 penargetan partner baru. Memperkenalkan alat untuk membantu pengguna secara proaktif menghindari tercapainya batas entitas akun. Menambahkan dukungan untuk item baris audio dan penggunaan algoritma bidding kustom di 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 yang menambahkan metode create 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 berdasarkan 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: channel, 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 berukuran besar, yang memperluas cakupan API di luar SDF. Menambahkan pengelolaan resource inti yang memungkinkan Anda membuat, mengambil, memperbarui, dan menghapus entity seperti pengiklan, kampanye, perjanjian 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.