Catatan Rilis

Halaman ini menyediakan catatan rilis untuk Display & Video 360 API.

Versi API terbaru: v3

4 Desember 2024

Fitur Baru

Menambahkan dukungan untuk nilai Exchange Core dan Tubi.

Meningkatkan ukuran halaman maksimum yang diizinkan untuk firstAndThirdPartyAudiences.list dari 200 menjadi 5000. Perbarui parameter pageSize permintaan firstAndThirdPartyAudiences.list Anda untuk lebih mengoptimalkan penggunaan kuota.

v3

• Nilai enum berikut telah ditambahkan:

  Enum	Nilai
  Exchange	EXCHANGE_CORE EXCHANGE_TUBI

• Ukuran halaman maksimum telah ditingkatkan untuk metode daftar berikut:

  Metode	Ukuran Halaman Maksimum Baru
  firstAndThirdPartyAudiences.list	5000

22 Oktober 2024

Fitur Baru

Menambahkan dukungan untuk sasaran performa biaya per penayangan.

Menambahkan kemampuan untuk menetapkan dan mengambil penargetan perangkat yang terhubung.

Menambahkan setelan keamanan merek Adloox baru di bagian penargetan verifier pihak ketiga.

Menambahkan dukungan untuk mendownload File Data Terstruktur v8, yang saat ini dalam versi beta tertutup.

v3

• Kolom berikut telah ditambahkan:

  Objek

  Kolom

  Adloox

  adultExplicitSexualContent armsAmmunitionContent crimeHarmfulActsIndividualsSocietyHumanRightsViolationsContent deathInjuryMilitaryConflictContent debatedSensitiveSocialIssueContent displayIabViewability excludedFraudIvtMfaCategories hateSpeechActsAggressionContent illegalDrugsTobaccoEcigarettesVapingAlcoholContent misinformationContent obscenityProfanityContent onlinePiracyContent spamHarmfulContent terrorismContent videoIabViewability

• Nilai enum berikut telah ditambahkan:

  Enum	Nilai
  DeviceType	DEVICE_TYPE_CONNECTED_DEVICE
  PerformanceGoalType	PERFORMANCE_GOAL_TYPE_CPV
  SdfVersion	SDF_VERSION_8

Nilai yang tidak digunakan lagi

Menghapus dukungan untuk SDF v5.5 karena penghentiannya pada 3 Oktober 2024.

v3

• Nilai enum berikut tidak digunakan lagi:

  Enum	Nilai
  SdfVersion	SDF_VERSION_5_5

15 Agustus 2024

Fitur Baru

Menambahkan dukungan untuk jenis Exchange Netflix.

v3

• Nilai enum berikut telah ditambahkan:

  Enum	Nilai
  Exchange	EXCHANGE_NETFLIX

v2

• Nilai enum berikut telah ditambahkan:

  Enum	Nilai
  Exchange	EXCHANGE_NETFLIX

15 Juli 2024

Fitur Baru

Menambahkan dukungan untuk mendownload File Data Terstruktur Item Baris dan Grup Iklan dalam format QA di v3.

v3

• Kolom berikut telah ditambahkan:

  Resource	Kolom
  IdFilter	adGroupQaIds lineItemQaIds

• 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 resource perjanjian pemasangan iklan. optimizationObjective hanya tersedia untuk pelanggan dalam daftar yang disetujui.

v3

• Kolom berikut telah ditambahkan:

  Resource	Kolom
  InsertionOrder	optimizationObjective

• 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 advertisers.targetingType.assignedTargetingOptions.get advertisers.targetingType.assignedTargetingOptions.list

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 advertisers.targetingType.assignedTargetingOptions.get advertisers.targetingType.assignedTargetingOptions.list

30 Mei 2024

Fitur Baru

Menambahkan 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 baru.

v3

• Kolom berikut telah ditambahkan:

  Resource	Kolom
  Kpi	kpiAlgorithmId

• Nilai enum berikut telah ditambahkan:

  Enum	Nilai
  AppPlatform	APP_PLATFORM_LG_TV APP_PLATFORM_VIZIO_TV
  Exchange	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
  Exchange	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	removedContactInfoList removedMobileDeviceIdList

• Nilai enum berikut telah ditambahkan:

  Enum	Nilai
  Exchange	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	removedContactInfoList removedMobileDeviceIdList

• Nilai enum berikut telah ditambahkan:

  Enum	Nilai
  Exchange	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 menginformasikan apakah item baris YouTube & Partners menyertakan inventaris Google TV dalam penargetan.

Menambahkan kolom baru untuk menyampaikan waktu login terakhir bagi pengguna Display & Video 360.

v3

• Metode berikut telah ditambahkan:

  Layanan	Metode
  floodlightGroups.floodlightActivities	get list

• Kolom berikut telah ditambahkan:

  Resource	Kolom
  Pengguna	lastLoginTime
  YoutubeAndPartnersInventorySourceConfig	includeGoogleTv

v2

• Metode berikut telah ditambahkan:

  Layanan	Metode
  floodlightGroups.floodlightActivities	get list

• Kolom berikut telah ditambahkan:

  Resource	Kolom
  Pengguna	lastLoginTime
  YoutubeAndPartnersInventorySourceConfig	includeGoogleTv

14 November 2023

Fitur Baru

Menambahkan dukungan untuk meneruskan izin pengguna akhir saat mengupload anggota audiens Match Pelanggan di semua versi aktif.

v3

• Kolom berikut telah ditambahkan:

  Resource	Kolom
  ContactInfoList	izin
  MobileDeviceIdList	izin

v2

• Kolom berikut telah ditambahkan:

  Resource	Kolom
  ContactInfoList	izin
  MobileDeviceIdList	consent

31 Oktober 2023

Fitur Baru

Memindahkan v3 dari versi beta publik 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

Merilis v3 dalam versi beta publik, yang mencakup perubahan berikut:

• Kemampuan untuk mengelola daftar lokasi kedekatan sepenuhnya, yang memungkinkan penggunaan layanan advertisers.locationLists.assignedLocations untuk membuat dan menghapus lokasi yang ditetapkan ke resource TARGETING_LOCATION_TYPE_PROXIMITY LocationList.
• Kolom enableOptimizedTargeting boolean baru, yang menggantikan kolom targetingExpansionLevel dalam objek TargetingExpansionConfig.
• Persyaratan kolom billingConfig di resource Advertiser, yang harus disertakan saat membuat permintaan advertisers.create, dan kolom billingConfig baru di resource Partner.
• Resource AdGroup dan AdGroupAd baru yang menggantikan resource YoutubeAdGroup dan YoutubeAdGroupAd di v2.

Ikuti langkah-langkah dalam panduan migrasi kami 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	get list
  advertisers.adGroups	bulkListAdGroupAssignedTargetingOptions get list
  advertisers.adGroups.targetingTypes.assignedTargetingOptions	get list
  customBiddingAlgorithms	uploadRules
  customBiddingAlgorithms.rules	create get list

• 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	Kini mendukung pembaruan resource TARGETING_LOCATION_TYPE_PROXIMITY LocationList.
  advertisers.locationLists.assignedLocations.bulkEdit	Sekarang mendukung pengeditan massal resource AssignedLocation di resource TARGETING_LOCATION_TYPE_PROXIMITY LocationList.
  advertisers.locationLists.assignedLocations.create	Kini mendukung pembuatan resource AssignedLocation di resource TARGETING_LOCATION_TYPE_PROXIMITY LocationList.

• Parameter kueri berikut telah ditambahkan:

  Metode	Parameter
  inventorySources.get	advertiserId

• Kolom berikut telah diwajibkan:

  Resource	Kolom
  Pengiklan	billingConfig

• Kolom berikut telah ditambahkan:

  Resource	Kolom
  BiddingStrategy	youtubeAndPartnersBid
  InsertionOrder	kpi
  Partner	billingConfig
  TargetingExpansionConfig	audienceExpansionLevel audienceExpansionSeedListExcluded enableOptimizedTargeting
  YoutubeAndPartnersSettings	thirdPartyMeasurementConfigs
  YoutubeAndPartnersInventorySourceConfig	includeYoutube

• 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 & Partner 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	effectiveContentCategory

• Kolom berikut telah dihapus:

  Resource	Kolom
  InventorySource	subSitePropertyId

• Nilai enum berikut telah ditambahkan:

  Enum	Nilai
  Exchange	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 tersebut memiliki kolom excludeFirstPartyAudience yang tidak digunakan lagi dan 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 tentang cara mengambil referensi YouTube & Partner untuk mengetahui informasi selengkapnya.

Menambahkan dukungan untuk empat pertukaran tambahan di v1 dan v2.

v2

• Metode berikut telah ditambahkan:

  Layanan	Metode
  advertisers.youtubeAdGroupAds	get list
  advertisers.youtubeAdGroups	bulkListAdGroupAssignedTargetingOptions get list
  advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions	get list

• Kolom berikut telah ditambahkan:

  Layanan	Metode
  AssignedTargetingOption	sessionPositionDetails youtubeChannelDetails youtubeVideoDetails
  YoutubeAndPartnersSettings	leadFormId linkedMerchantId relatedVideoIds targetFrequency videoAdSequenceSettings

• Nilai enum berikut telah ditambahkan:

  Enum	Nilai
  Exchange	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
  Exchange	EXCHANGE_APPLOVIN EXCHANGE_CONNATIX EXCHANGE_JCD EXCHANGE_PLACE_EXCHANGE

6 Desember 2022

Fitur Baru

Memindahkan v2 dari versi 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.

Meningkatkan ukuran halaman maksimum menjadi 200 untuk berbagai metode list di v1 dan v2. Ukuran halaman default tidak berubah.

v2

• Kolom berikut telah ditambahkan:

  Resource	Kolom
  Pengiklan	billingConfig
  AssignedTargetingOption	assignedTargetingOptionIdAlias

• 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:

  Metode	Ukuran Halaman Maksimum Baru
  advertisers.campaigns.list	200
  advertisers.channels.list	200
  advertisers.creatives.list	200
  advertisers.invoices.list	200
  advertisers.lineItems.list	200
  advertisers.list	200
  advertisers.locationLists.assignedLocations.list	200
  advertisers.locationLists.list	200
  advertisers.manualTriggers.list	200
  advertisers.negativeKeywordLists.list	200
  combinedAudiences.list	200
  customBiddingAlgorithms.list	200
  customBiddingAlgorithms.scripts.list	200
  customLists.list	200
  firstAndThirdPartyAudiences.list	200
  googleAudiences.list	200
  guaranteedOrders.list	200
  inventorySourceGroups.list	200
  inventorySources.list	200
  partners.channels.list	200
  partners.list	200
  partners.targetingTypes.assignedTargetingOptions.list	200
  targetingTypes.targetingOptions.list	200
  targetingTypes.targetingOptions.search	200
  users.list	200

v1

• Ukuran halaman maksimum telah ditingkatkan untuk metode daftar berikut:

  Metode	Ukuran Halaman Maksimum Baru
  advertisers.campaigns.list	200
  advertisers.channels.list	200
  advertisers.creatives.list	200
  advertisers.invoices.list	200
  advertisers.lineItems.list	200
  advertisers.list	200
  advertisers.locationLists.assignedLocations.list	200
  advertisers.locationLists.list	200
  advertisers.manualTriggers.list	200
  advertisers.negativeKeywordLists.list	200
  combinedAudiences.list	200
  customBiddingAlgorithms.list	200
  customBiddingAlgorithms.scripts.list	200
  customLists.list	200
  firstAndThirdPartyAudiences.list	200
  googleAudiences.list	200
  guaranteedOrders.list	200
  inventorySourceGroups.list	200
  inventorySources.list	200
  partners.channels.list	200
  partners.list	200
  partners.targetingTypes.assignedTargetingOptions.list	200
  targetingTypes.targetingOptions.list	200
  targetingTypes.targetingOptions.search	200
  users.list	200

Masalah umum

Update ini memperbaiki masalah umum berikut di v2:

• Opsi penargetan yang ditetapkan dari jenis penargetan yang ditetapkan menggunakan nilai enum di v2 tidak dapat dihapus atau diambil menggunakan assignedTargetingOptionId, dan sebagai gantinya, pengguna diharapkan menggunakan nilai enum. Dengan update ini, opsi penargetan yang ditetapkan ini dapat dihapus atau diambil menggunakan assignedTargetingOptionId atau nilai enum, yang diidentifikasi oleh kolom assignedTargetingOptionIdAlias baru di resource AssignedTargetingOption.
• Permintaan item baris bulkUpdate tidak menggunakan parameter permintaan advertisersId dengan benar, sehingga menampilkan error. Dengan update ini, metode telah diperbaiki dan parameter permintaan telah diganti namanya dari advertisersId menjadi advertiserId.

27 Oktober 2022

Menambahkan kemampuan untuk menduplikasi item baris yang ada dalam InsertionOrder induk.

Memperkenalkan dukungan penulisan penargetan pesanan pemasangan 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	create hapus
  advertisers.lineItems	duplikat

v1

Tidak ada fitur baru yang ditambahkan ke v1.

20 September 2022

Merilis v2 dalam versi beta publik, yang mencakup perubahan berikut:

• Kemampuan untuk mengambil item baris YouTube & Partners dan setelan penargetan mereka menggunakan metode get dan list di layanan advertisers.lineItems dan advertisers.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 memperbarui entityStatus 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 layanan targetingTypes.targetingOptions.

Ikuti langkah-langkah dalam panduan migrasi kami untuk bermigrasi dari v1 ke v2.

Menambahkan dukungan untuk tiga pertukaran 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 bulkListAssignedTargetingOptions bulkUpdate

• 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	editAssignedTargetingOptions listAssignedTargetingOptions
  advertisers.campaigns	bulkListCampaignAssignedTargetingOptions	listAssignedTargetingOptions
  advertisers.insertionOrders	bulkListInsertionOrderAssignedTargetingOptions	listAssignedTargetingOptions
  partners	bulkEditPartnerAssignedTargetingOptions	editAssignedTargetingOptions

• Resource AssignedTargetingOption dari jenis penargetan berikut menggunakan enum untuk penetapan penargetan di v2. Kolom assignedTargetingOptionId untuk resource AssignedTargetingOption dari 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	Exchange
  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:

  Resource	Kolom
  CustomBiddingAlgorithm	modelDetails
  DeviceTypeAssignedTargetingOptionDetails	youtubeAndPartnersBidMultiplier
  DigitalContentLabelAssignedTargetingOptionDetails	excludedContentRatingTier
  ExchangeAssignedTargetingOptionDetails	exchange
  FrequencyCap	maxViews
  ItemBaris	youtubeAndPartnersSettings
  ProximityLocationListAssignedTargetingOptionDetails	proximityRadius proximityRadiusUnit
  SensitiveCategoryAssignedTargetingOptionDetails	excludedSensitiveCategory

• Kolom berikut telah dihapus di v2:

  Resource	Kolom
  AgeRangeAssignedTargetingOptionDetails	targetingOptionId
  ContentInstreamPositionAssignedTargetingOptionDetails	targetingOptionId
  ContentOutstreamPositionAssignedTargetingOptionDetails	targetingOptionId
  CustomBiddingAlgorithm	customBiddingAlgorithmState
  DeviceTypeAssignedTargetingOptionDetails	targetingOptionId
  DigitalContentLabelAssignedTargetingOptionDetails	contentRatingTier excludedTargetingOptionId
  EnvironmentAssignedTargetingOptionDetails	targetingOptionId
  ExchangeAssignedTargetingOptionDetails	targetingOptionId
  GenderAssignedTargetingOptionDetails	targetingOptionId
  HouseholdIncomeAssignedTargetingOptionDetails	targetingOptionId
  ItemBaris	inventorySourceIds
  LineItemFlight	triggerId
  NativeContentPositionAssignedTargetingOptionDetails	targetingOptionId
  OmidAssignedTargetingOptionDetails	targetingOptionId
  ParentalStatusAssignedTargetingOptionDetails	targetingOptionId
  ProximityLocationListAssignedTargetingOptionDetails	proximityRadiusRange
  SensitiveCategoryAssignedTargetingOptionDetails	excludedTargetingOptionId sensitiveCategory
  VideoPlayerSizeAssignedTargetingOptionDetails	targetingOptionId
  ViewabilityAssignedTargetingOptionDetails	targetingOptionId

• Kolom berikut telah diwajibkan di v2:

  Resource	Kolom
  AgeRangeAssignedTargetingOptionDetails	ageRange
  ContentInstreamPositionAssignedTargetingOptionDetails	contentInstreamPosition
  ContentOutstreamPositionAssignedTargetingOptionDetails	contentOutstreamPosition
  DeviceTypeAssignedTargetingOptionDetails	deviceType
  DigitalContentLabelAssignedTargetingOptionDetails	excludedContentRatingTier
  EnvironmentAssignedTargetingOptionDetails	environment
  ExchangeAssignedTargetingOptionDetails	exchange
  GenderAssignedTargetingOptionDetails	gender
  HouseholdIncomeAssignedTargetingOptionDetails	householdIncome
  NativeContentPositionAssignedTargetingOptionDetails	contentPosition
  OmidAssignedTargetingOptionDetails	omid
  ParentalStatusAssignedTargetingOptionDetails	parentalStatus
  SensitiveCategoryAssignedTargetingOptionDetails	excludedSensitiveCategory
  VideoPlayerSizeAssignedTargetingOptionDetails	videoPlayerSize
  ViewabilityAssignedTargetingOptionDetails	visibilitas

• 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
  Exchange	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
  Exchange	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	create editGuaranteedOrderReadAccessors get list patch
  inventorySources	create editInventorySourceReadWriteAccessors patch

• Kolom berikut telah ditambahkan:

  Resource	Kolom
  CustomBiddingAlgorithm	modelReadiness
  InventorySource	inventorySourceProductType guaranteedOrderId readAdvertiserIds readPartnerIds readWriteAccessors

• Nilai enum berikut telah ditambahkan:

  Enum	Nilai
  SdfVersion	SDF_VERSION_5_5

• Metode daftar berikut kini dapat difilter berdasarkan properti berikut:

  Metode	Kolom
  advertisers.creatives.list	updateTime

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	contentDurationDetails contentGenreDetails contentStreamTypeDetails
  InsertionOrder	billableOutcome
  MaximizeSpendBidStrategy	raiseBidForDeals
  TargetingOption	contentDurationDetails contentGenreDetails contentStreamTypeDetails

• Nilai enum berikut telah ditambahkan:

  Enum	Nilai
  TargetingType	TARGETING_TYPE_CONTENT_DURATION TARGETING_TYPE_CONTENT_GENRE TARGETING_TYPE_CONTENT_STREAM_TYPE

2 Februari 2022

Menambahkan dukungan untuk membuat, memperbarui, dan mengedit anggota resource FirstAndThirdPartyAudience Pencocokan Pelanggan tertentu. Halaman Upload Audiens Customer Match dalam panduan Menggunakan Audiens baru kami menjelaskan cara menggunakan fitur baru ini.

Memperkenalkan kolom reservationType baru di resource InsertionOrder dan LineItem yang mengidentifikasi apakah resource dijamin Tag, Dijamin Programmatik, atau tidak dijamin.

Menambahkan kemampuan untuk mengambil dan menetapkan apakah item baris secara otomatis menargetkan bursa baru melalui kolom excludeNewExchanges baru.

Selain fitur baru, batas kuota default telah digandakan.

Fitur Baru

• Metode berikut telah ditambahkan:

  Layanan	Metode
  firstAndThirdPartyAudiences	create editCustomerMatchMembers patch

• Kolom berikut telah ditambahkan:

  Resource	Kolom
  FirstAndThirdPartyAudience	appId contactInfoList mobileDeviceIdList
  InsertionOrder	reservationType
  ItemBaris	excludeNewExchanges reservationType

8 Desember 2021

Menambahkan dukungan untuk penargetan jenis konten audio pada jenis penargetan TARGETING_TYPE_AUDIO_CONTENT_TYPE.

Fitur Baru

• Kolom berikut telah ditambahkan:

  Resource	Kolom
  AssignedTargetingOption	audioContentTypeDetails
  TargetingOption	audioContentTypeDetails

• Nilai enum berikut telah ditambahkan:

  Enum	Nilai
  TargetingType	TARGETING_TYPE_AUDIO_CONTENT_TYPE

8 November 2021

Menambahkan dukungan penuh untuk mengelola algoritma bidding kustom dan skripnya. Hal ini mencakup:

• Fungsi untuk membuat customBiddingAlgorithms baru dan memperbarui customBiddingAlgorithms yang 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 membuat customBiddingScripts.

Halaman Menerapkan 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	create patch uploadScript
  customBiddingAlgorithms.scripts	create get list
  media	upload

• Nilai enum berikut telah ditambahkan:

  Enum	Nilai
  SdfVersion	SDF_VERSION_5_4

14 September 2021

Menambahkan dukungan untuk penargetan kedekatan berdasarkan 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 tidak dapat diambil melalui metode targetingTypes.targetingOptions.get atau targetingTypes.targetingOptions.list.

Memperkenalkan kolom sharedAdvertiserIds dan customBiddingAlgorithmState baru ke resource Algoritme Bidding Kustom dan menambahkan dukungan untuk jenis algoritme bidding kustom GOAL_BUILDER_BASED.

Menambahkan dua nilai baru ke enum Exchange.

Fitur Baru

• Kolom berikut telah ditambahkan:

  Resource	Kolom
  AssignedTargetingOption	businessChainDetails poiDetails
  CustomBiddingAlgorithm	customBiddingAlgorithmState sharedAdvertiserIds
  TargetingOption	businessChainDetails poiDetails
  Isi Permintaan TargetingOptions.search	businessChainSearchTerms poiSearchTerms

• Nilai enum berikut telah ditambahkan:

  Enum	Nilai
  CustomBiddingAlgorithmType	GOAL_BUILDER_BASED
  Exchange	EXCHANGE_RED_FOR_PUBLISHERS EXCHANGE_TAPJOY
  TargetingType	TARGETING_TYPE_BUSINESS_CHAIN TARGETING_TYPE_POI

• Metode daftar berikut kini dapat difilter berdasarkan properti berikut:

  Metode	Kolom
  customBiddingAlgorithms.list	customBiddingAlgorithmState

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 dalam satu halaman dari berbagai metode daftar opsi penargetan yang ditetapkan pengiklan, kampanye, pesanan pemasangan, dan item baris menggunakan parameter metode pageSize.

Fitur Baru

• Kolom berikut telah ditambahkan:

  Resource	Kolom
  AssignedTargetingOption	omidDetails
  TargetingOption	omidDetails

• Nilai enum berikut telah ditambahkan:

  Enum	Nilai
  TargetingType	TARGETING_TYPE_OMID

• Ukuran halaman maksimum telah ditingkatkan untuk metode daftar berikut:

  Metode	Ukuran Halaman Maksimum Baru
  advertisers.campaigns.targetingTypes.assignedTargetingOptions.list	5000
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.list	5000
  advertisers.lineItems.targetingTypes.assignedTargetingOptions.list	5000
  advertisers.targetingTypes.assignedTargetingOptions.list	5000

26 Mei 2021

Meluncurkan layanan advertisers.invoices, yang memungkinkan pengguna:

• mengambil invoice yang dikeluarkan kepada 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, yang membatasi jumlah anggaran segmen terkait dengan jumlah total anggaran kampanye.

Menambahkan dukungan untuk penargetan posisi konten native berdasarkan 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	list lookupInvoiceCurrency

• Kolom berikut telah ditambahkan:

  Resource	Kolom
  Pengiklan	prismaEnabled
  AssignedTargetingOption	nativeContentPositionDetails
  Kampanye	campaignBudgets
  TargetingOption	nativeContentPositionDetails

• Nilai enum berikut telah ditambahkan:

  Enum	Nilai
  AssignedTargetingOption.Recency	RECENCY_45_DAYS
  Exchange	EXCHANGE_MEDIANET
  TargetingType	TARGETING_TYPE_NATIVE_CONTENT_POSITION

• Nilai enum berikut kini valid untuk kolom berikut:

  Resource	Kolom	Nilai
  Pengiklan	entityStatus	ENTITY_STATUS_PAUSED

29 April 2021

Menambahkan kolom baru ke resource Channel dan Daftar Kata Kunci Negatif yang menampilkan jumlah item baris yang menggunakan resource untuk penargetan. Mengaktifkan properti filter baru untuk metode daftar item baris yang memungkinkan pengguna hanya mengambil item baris yang menggunakan saluran tertentu atau daftar kata kunci negatif dalam penargetan mereka.

Fitur Baru

• Kolom berikut telah ditambahkan:

  Resource	Kolom
  Kanal	negativelyTargetedLineItemCount positivelyTargetedLineItemCount
  NegativeKeywordList	targetedLineItemCount

• 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 diberikan, serta setelan dan penargetan yang ditetapkan untuk pesanan pemasangan 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.

Melakukan beberapa perubahan pada layanan advertisers.channels.sites, partners.channels.sites, dan advertisers.negativeKeywordLists.negativeKeywords untuk mempermudah pengelolaan konten channel dan daftar kata kunci negatif. Perubahan ini mencakup:

• Penambahan metode replace, yang memungkinkan pengguna menimpa sepenuhnya konten yang ada di channel atau daftar kata kunci negatif.
• Penghapusan persyaratan bahwa tidak ada item yang ada yang disertakan dalam kolom createdSites atau createdNegativeKeywords dari permintaan pengeditan massal.
• Peningkatan jumlah maksimum item yang dapat ditampilkan di satu halaman respons daftar situs atau daftar kata kunci negatif.

Fitur Baru

• Metode berikut telah ditambahkan:

  Layanan	Metode
  advertisers.campaigns	bulkListCampaignAssignedTargetingOptions
  advertisers.campaigns.targetingTypes.assignedTargetingOptions	get list
  advertisers.channels.sites	replace
  advertisers.lineItems	generateDefault
  advertisers.negativeKeywordLists.negativeKeywords	replace
  partners.channels.sites	replace

• Kolom berikut telah ditambahkan:

  Resource	Kolom
  AssignedTargetingOption.AppAssignedTargetingOptionDetails	appPlatform

• Ukuran halaman maksimum telah ditingkatkan untuk metode daftar berikut:

  Metode	Ukuran Halaman Maksimum Lama	Ukuran Halaman Maksimum 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 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 oleh resource pesanan pemasangan dan kampanye.

Fitur Baru

• Metode berikut telah ditambahkan:

  Layanan	Metode
  advertisers.insertionOrders	bulkListInsertionOrderAssignedTargetingOptions
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions	get list

• Kolom berikut telah ditambahkan:

  Resource	Kolom
  Materi iklan	mp3Audio oggAudio

• Nilai enum berikut telah ditambahkan:

  Enum	Nilai
  ContentInstreamPosition	CONTENT_INSTREAM_POSITION_UNKNOWN
  PerformanceGoalType	PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE PERFORMANCE_GOAL_TYPE_CLICK_CVR PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR PERFORMANCE_GOAL_TYPE_VCPM PERFORMANCE_GOAL_TYPE_VIDEO_COMPLETION_RATE PERFORMANCE_GOAL_TYPE_VTR

27 Januari 2021

Mengaktifkan pengambilan dan pengelolaan perjanjian pemasangan iklan TV dan item baris over-the-top melalui pengenalan kolom InsertionOrderType baru dan nilai enum LineItemType baru. Menambahkan dukungan untuk item baris aplikasi seluler melalui kolom item baris mobileApp. Dukungan bursa, audiens google, dan SDF yang diperluas melalui nilai enum tambahan. Memperkenalkan kemampuan untuk memfilter dan mengurutkan nilai advertisers.list berdasarkan waktu pembaruan terakhir.

Fitur Baru

• Kolom berikut telah ditambahkan:

  Resource	Kolom
  InsertionOrder	insertionOrderType
  LineItem	mobileApp

• Nilai enum berikut telah ditambahkan:

  Enum	Nilai
  Exchange	EXCHANGE_SHARETHROUGH EXCHANGE_SOUNDCAST
  GoogleAudienceType	GOOGLE_AUDIENCE_TYPE_EXTENDED_DEMOGRAPHIC GOOGLE_AUDIENCE_TYPE_LIFE_EVENT
  LineItemType	LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP
  SdfVersion	SDF_VERSION_5_3

• Metode daftar berikut kini dapat diurutkan dan difilter berdasarkan kolom berikut:

  Metode	Kolom
  pengiklan	updateTime

4 Desember 2020

Menambahkan kemampuan untuk menelusuri opsi penargetan Wilayah Geografis dan memfilter beberapa hasil metode daftar resource menurut waktu pembaruan terakhirnya. Memperkenalkan LineItemWarningMessage baru untuk memberi tahu pengguna kapan item baris menggunakan penargetan geografis yang tidak digunakan lagi.

Fitur Baru

• Metode berikut telah ditambahkan:

  Layanan	Metode
  targetingTypes.targetingOptions	search

• Nilai enum berikut telah ditambahkan:

  Enum	Nilai
  Exchange	EXCHANGE_SUPERSHIP
  LineItemWarningMessage	TARGETING_DEPRECATED_GEO_TARGET

• Metode daftar berikut kini dapat diurutkan dan difilter berdasarkan kolom berikut:

  Metode	Kolom
  advertisers.campaigns.list	updateTime
  advertisers.insertionOrders.list	updateTime
  advertisers.lineItems.list	updateTime

5 November 2020

Menambahkan kemampuan untuk membuat, menetapkan, dan mengaktifkan pemicu manual yang memulai pembelanjaan item baris terkait. Memperkenalkan opsi perluasan penargetan yang, jika ditetapkan, dapat memperluas penargetan item baris untuk menyertakan pengguna yang mirip dengan pengguna dalam audiens yang ditargetkan. 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	activate create nonaktifkan get list patch

• Kolom berikut telah ditambahkan:

  Resource	Kolom
  AssignedTargetingOption.DoubleVerify	customSegmentId
  AssignedTargetingOption.IntegralAdScience	customSegmentId
  LineItem	targetingExpansion
  LineItemFlight	triggerId

• Nilai enum berikut telah ditambahkan:

  Enum	Nilai
  LineItemFlightDateType	LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER

• Metode daftar berikut kini dapat difilter berdasarkan kolom berikut:

  Metode	Kolom
  advertisers.lineItems.list	filter.triggerId

12 Oktober 2020

Memperkenalkan pesan peringatan yang dapat diambil 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 kini berlaku dan dokumentasi baru tentang menggunakan permintaan batch tersedia.

Fitur Baru

• Kolom berikut telah ditambahkan:

  Resource	Kolom
  LineItem	warningMessages

• Nilai enum berikut telah ditambahkan:

  Enum	Nilai
  PerformanceGoalType	PERFORMANCE_GOAL_TYPE_CTR

• Metode daftar berikut kini dapat difilter berdasarkan kolom berikut:

  Metode	Kolom
  advertisers.lineItems.list	warningMessages

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 Advertisers.Audit	adGroupCriteriaCount campaignCriteriaCount channelsCount negativeKeywordListsCount negativelyTargetedChannelsCount

• Metode daftar berikut kini dapat difilter berdasarkan kolom berikut:

  Metode	Kolom
  advertisers.list	advertiserId displayName
  advertisers.campaigns.list	campaignId displayName
  advertisers.insertionOrders.list	budget.budget_segments.date_range.end_date displayName
  advertisers.lineItems.list	displayName lineItemId
  targetingTypes.targetingOptions.list	carrierAndIspDetails.type geoRegionDetails.geo_region_type

4 Agustus 2020

Meluncurkan layanan pengelolaan pengguna, partner, dan penargetan partner baru. Memperkenalkan alat untuk membantu pengguna secara proaktif menghindari batas entitas akun. Menambahkan dukungan untuk item baris audio dan penggunaan algoritma bidding kustom dalam strategi bidding item baris dan perjanjian pemasangan iklan.

Fitur Baru

• Layanan berikut telah ditambahkan:

  Layanan	Metode
  customBiddingAlgorithms	get list
  partner	bulkEditPartnerAssignedTargetingOptions get list
  partners.targetingTypes.assignedTargetingOptions	create delete get list
  pengguna	bulkEditAssignedUserRoles create delete get list patch

• Metode berikut telah ditambahkan:

  Layanan	Metode
  pengiklan	audit

• Kolom berikut telah ditambahkan:

  Resource	Kolom
  MaximizeSpendBidStrategy	customBiddingAlgorithmId
  PerformanceGoalBidStrategy	customBiddingAlgorithmId

• Nilai enum berikut telah ditambahkan:

  Enum	Nilai
  BiddingStrategyPerformanceGoalType	BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO
  LineItemType	LINE_ITEM_TYPE_AUDIO_DEFAULT

• Metode daftar berikut kini dapat diurutkan dan difilter berdasarkan kolom berikut:

  Metode	Kolom
  advertisers.lineItems.list	flight.dateRange.endDate

• Cakupan berikut telah ditambahkan untuk digunakan untuk layanan berikut:

  Cakupan	Layanan
  https://www.googleapis.com/auth/display-video-user-management	pengguna

24 Juni 2020

Meluncurkan update kecil yang menambahkan metode pembuatan untuk saluran partner dan pengiklan, kolom FirstAndThirdPartyAudience baru, dan nilai enum exchange tambahan.

Fitur Baru

• Layanan berikut telah ditambahkan:

  Layanan	Metode
  advertisers.channels	create
  partners.channels	create

• Kolom berikut telah ditambahkan:

  Resource	Kolom
  FirstAndThirdPartyAudience	activeDisplayAudienceSize audienceSource audienceType deskripsi displayAudienceSize displayDesktopAudienceSize displayMobileAppAudienceSize displayMobileWebAudienceSize gmailAudienceSize membershipDurationDays youtubeAudienceSize

• Nilai enum berikut telah ditambahkan:

  Enum	Nilai
  Exchange	EXCHANGE_OPEN8 EXCHANGE_TRITON EXCHANGE_UNRULYX

• Metode daftar berikut kini dapat difilter berdasarkan kolom berikut:

  Metode	Kolom
  advertisers.creatives.list	creativeId

02 Juni 2020

Memperkenalkan kemampuan untuk membuat, menerapkan patch, dan mengisi sebagian 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:

  Layanan	Metode
  advertisers.channels.sites	bulkEdit create delete list
  advertisers.locationLists.assignedLocations	bulkEdit create delete list
  advertisers.negativeKeywordLists.negativeKeywords	bulkEdit create delete list
  advertisers.targetingTypes.assignedTargetingOptions	create delete get list
  inventorySourceGroups.assignedInventorySources	bulkEdit create delete list
  partners.channels.sites	bulkEdit create delete list

• Metode berikut telah ditambahkan:

  Layanan	Metode
  pengiklan	bulkEditAdvertiserAssignedTargetingOptions bulkListAdvertiserAssignedTargetingOptions
  advertisers.channels	patch
  advertisers.locationLists	create patch
  advertisers.negativeKeywordLists	create delete patch
  inventorySourceGroups	create delete patch
  partners.channels	patch

• Kolom berikut telah ditambahkan:

  Resource	Kolom
  pengiklan	servingConfig
  materi iklan	lineItemIds
  insertionOrder.insertionOrderBudgetSegment	campaignBudgetId

27 April 2020

Meluncurkan set fitur besar, yang memperluas cakupan API di luar SDF. Menambahkan pengelolaan resource inti yang memungkinkan Anda membuat, mengambil, memperbarui, dan menghapus entitas seperti pengiklan, kampanye, pesanan penyisipan, item baris, dan materi iklan. Kemampuan baru juga memungkinkan pengeditan penargetan di tingkat item baris.

Fitur Baru

Layanan berikut telah ditambahkan:

Layanan	Metode
pengiklan	create delete get list patch
advertisers.assets	upload
advertisers.campaigns	create delete get list patch
advertisers.channels	get list
advertisers.creatives	create delete get list patch
advertisers.insertionOrders	create delete get list patch
advertisers.lineItems	bulkEditLineItemAssignedTargetingOptions bulkListLineItemAssignedTargetingOptions create delete get list patch
advertisers.lineItems.targetingTypes.assignedTargetingOptions	create delete get list
advertisers.locationLists	get list
advertisers.negativeKeywordLists	get list
combinedAudiences	get list
customLists	get list
firstAndThirdPartyAudiences	get list
floodlightGroups	get patch
googleAudiences	get list
inventorySourceGroups	get list
inventorySources	get list
partners.channels	get list
partners.channels	get list

9 Maret 2020

Meluncurkan Display & Video 360 API v1. Ini adalah versi awal API.

Masalah umum

Tidak ada.