Ghi chú phát hành đã lưu trữ

Trang này cung cấp ghi chú phát hành cho các phiên bản ngừng hoạt động của Display & Video 360 API.

Chuyển đến trang ghi chú phát hành chính của chúng tôi để xem tất cả các bản phát hành cho phiên bản chính thức.

Ngày 4 tháng 12 năm 2024

Tính năng mới

Thêm chế độ hỗ trợ cho các giá trị Core và Tubi Exchange.

Tăng kích thước trang tối đa cho phép đối với firstAndThirdPartyAudiences.list từ 200 lên 5000. Cập nhật tham số pageSize của các yêu cầu firstAndThirdPartyAudiences.list để tối ưu hoá hơn nữa việc sử dụng hạn mức.

v3

• Các giá trị enum sau đây đã được thêm:

  Enum	Giá trị
  Exchange	EXCHANGE_CORE EXCHANGE_TUBI

• Kích thước trang tối đa đã được tăng lên cho các phương thức danh sách sau:

  Phương thức	Kích thước trang tối đa mới
  firstAndThirdPartyAudiences.list	5000

Ngày 22 tháng 10 năm 2024

Tính năng mới

Thêm tính năng hỗ trợ cho mục tiêu hiệu suất chi phí mỗi lượt xem.

Thêm chức năng đặt và truy xuất tiêu chí nhắm mục tiêu của các thiết bị đã kết nối.

Đã thêm chế độ cài đặt mới về sự an toàn cho thương hiệu của Adloox trong mục nhắm mục tiêu theo đối tác xác minh bên thứ ba.

Thêm tính năng hỗ trợ tải Tệp dữ liệu có cấu trúc phiên bản 8 xuống. Tính năng này hiện đang ở giai đoạn thử nghiệm beta khép kín.

v3

• Các trường sau đã được thêm:

  Đối tượng

  (Các) trường

  Adloox

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

• Các giá trị enum sau đây đã được thêm:

  Enum	Giá trị
  DeviceType	DEVICE_TYPE_CONNECTED_DEVICE
  PerformanceGoalType	PERFORMANCE_GOAL_TYPE_CPV
  SdfVersion	SDF_VERSION_8

Giá trị không dùng nữa

Ngừng hỗ trợ SDF phiên bản 5.5 do ngừng cung cấp vào ngày 3 tháng 10 năm 2024.

v3

• Các giá trị enum sau đây không được dùng nữa:

  Enum	Giá trị
  SdfVersion	SDF_VERSION_5_5

Ngày 15 tháng 8 năm 2024

Tính năng mới

Thêm tính năng hỗ trợ cho loại Exchange của Netflix.

v3

• Các giá trị enum sau đây đã được thêm:

  Enum	Giá trị
  Exchange	EXCHANGE_NETFLIX

phiên bản 2

• Các giá trị enum sau đây đã được thêm:

  Enum	Giá trị
  Exchange	EXCHANGE_NETFLIX

Ngày 15 tháng 7 năm 2024

Tính năng mới

Thêm tính năng hỗ trợ tải tệp dữ liệu có cấu trúc về Mục riêng và Nhóm quảng cáo xuống ở định dạng QA trong phiên bản 3.

v3

• Các trường sau đã được thêm:

  Tài nguyên	(Các) trường
  IdFilter	adGroupQaIds lineItemQaIds

• Các giá trị enum sau đây đã được thêm:

  Enum	Giá trị
  FileType	FILE_TYPE_AD_GROUP_QA FILE_TYPE_LINE_ITEM_QA

Ngày 17 tháng 6 năm 2024

Tính năng mới

Thêm tính năng hỗ trợ để quản lý tiêu chí nhắm mục tiêu theo từ khoá được chỉ định ở cấp nhà quảng cáo.

Đã thêm trường optimizationObjective mới vào tài nguyên đơn đặt hàng quảng cáo. optimizationObjective chỉ dành cho những khách hàng được đưa vào danh sách cho phép.

v3

• Các trường sau đã được thêm:

  Tài nguyên	(Các) trường
  InsertionOrder	optimizationObjective

• Các phương thức sau hiện hỗ trợ các loại tiêu chí nhắm mục tiêu sau:

  Loại nhắm mục tiêu	Phương thức
  TARGETING_TYPE_KEYWORD	advertisers.editAssignedTargetingOptions advertisers.listAssignedTargetingOptions advertisers.targetingType.assignedTargetingOptions.create advertisers.targetingType.assignedTargetingOptions.delete advertisers.targetingType.assignedTargetingOptions.get advertisers.targetingType.assignedTargetingOptions.list

phiên bản 2

• Các phương thức sau hiện hỗ trợ các loại tiêu chí nhắm mục tiêu sau:

  Loại nhắm mục tiêu	Phương thức
  TARGETING_TYPE_KEYWORD	advertisers.editAssignedTargetingOptions advertisers.listAssignedTargetingOptions advertisers.targetingType.assignedTargetingOptions.create advertisers.targetingType.assignedTargetingOptions.delete advertisers.targetingType.assignedTargetingOptions.get advertisers.targetingType.assignedTargetingOptions.list

Ngày 30 tháng 5 năm 2024

Tính năng mới

Thêm tính năng hỗ trợ cho Tệp dữ liệu có cấu trúc (SDF) phiên bản 7.1.

v3

• Các giá trị enum sau đây đã được thêm:

  Enum	Giá trị
  SdfVersion	SDF_VERSION_7_1

phiên bản 2

• Các giá trị enum sau đây đã được thêm:

  Enum	Giá trị
  SdfVersion	SDF_VERSION_7_1

Ngày 23 tháng 4 năm 2024

Tính năng mới

Đã thêm tính năng hỗ trợ cho các loại KPI, sàn giao dịch và nền tảng ứng dụng mới.

v3

• Các trường sau đã được thêm:

  Tài nguyên	(Các) trường
  Kpi	kpiAlgorithmId

• Các giá trị enum sau đây đã được thêm:

  Enum	Giá trị
  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

phiên bản 2

• Các giá trị enum sau đây đã được thêm:

  Enum	Giá trị
  AppPlatform	APP_PLATFORM_LG_TV APP_PLATFORM_VIZIO_TV
  Exchange	EXCHANGE_DRAX
  YoutubeAndPartnersBiddingStrategyType	YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM

Ngày 28 tháng 2 năm 2024

Tính năng mới

Thêm khả năng xoá thành viên khỏi đối tượng so khớp khách hàng một cách rõ ràng.

Đã thêm tính năng hỗ trợ nhắm đến các Ad Exchange mới.

v3

• Các trường sau đã được thêm:

  Tài nguyên	(Các) trường
  firstAndThirdPartyAudiences.editCustomerMatchMembers	removedContactInfoList removedMobileDeviceIdList

• Các giá trị enum sau đây đã được thêm:

  Enum	Giá trị
  Exchange	EXCHANGE_ADMOST_GBID EXCHANGE_APPLOVIN_GBID EXCHANGE_CHARTBOOST_GBID EXCHANGE_FYBER_GBID EXCHANGE_TOPON_GBID EXCHANGE_UNITY_GBID

phiên bản 2

• Các trường sau đã được thêm:

  Tài nguyên	(Các) trường
  firstAndThirdPartyAudiences.editCustomerMatchMembers	removedContactInfoList removedMobileDeviceIdList

• Các giá trị enum sau đây đã được thêm:

  Enum	Giá trị
  Exchange	EXCHANGE_ADMOST_GBID EXCHANGE_APPLOVIN_GBID EXCHANGE_CHARTBOOST_GBID EXCHANGE_FYBER_GBID EXCHANGE_TOPON_GBID EXCHANGE_UNITY_GBID

Ngày 29 tháng 1 năm 2024

Tính năng mới

Thêm khả năng truy xuất các hoạt động Floodlight thông qua một dịch vụ floodlightGroups.floodlightActivities mới.

Thêm một trường mới cho biết liệu mục hàng YouTube và Đối tác có bao gồm khoảng không quảng cáo trên Google TV trong tiêu chí nhắm mục tiêu hay không.

Đã thêm một trường mới để chuyển tiếp thời gian đăng nhập gần đây nhất cho một người dùng Display & Video 360.

v3

• Các phương thức sau đã được thêm:

  Dịch vụ	Phương thức
  floodlightGroups.floodlightActivities	get list

• Các trường sau đã được thêm:

  Tài nguyên	(Các) trường
  Người dùng	lastLoginTime
  YoutubeAndPartnersInventorySourceConfig	includeGoogleTv

phiên bản 2

• Các phương thức sau đã được thêm:

  Dịch vụ	Phương thức
  floodlightGroups.floodlightActivities	get list

• Các trường sau đã được thêm:

  Tài nguyên	(Các) trường
  Người dùng	lastLoginTime
  YoutubeAndPartnersInventorySourceConfig	includeGoogleTv

Ngày 14 tháng 11 năm 2023

Tính năng mới

Thêm tính năng hỗ trợ truyền sự đồng ý của người dùng cuối khi tải thành viên đối tượng So khớp khách hàng lên trong tất cả các phiên bản chính thức.

v3

• Các trường sau đã được thêm:

  Tài nguyên	(Các) trường
  ContactInfoList	sự đồng ý
  MobileDeviceIdList	sự đồng ý

phiên bản 2

• Các trường sau đã được thêm:

  Tài nguyên	(Các) trường
  ContactInfoList	sự đồng ý
  MobileDeviceIdList	sự đồng ý

Ngày 31 tháng 10 năm 2023

Tính năng mới

Chuyển phiên bản 3 từ giai đoạn thử nghiệm beta công khai sang giai đoạn phát hành rộng rãi.

Đổi tên giá trị enum AdGroupFormat trong phiên bản 3 để phản ánh chính xác hơn định dạng có liên quan.

Thêm tính năng hỗ trợ cho Tệp dữ liệu có cấu trúc phiên bản 7 bằng cách thêm giá trị enum SDF_VERSION_7 trong phiên bản 2 và 3.

v3

• Các giá trị enum sau đây đã bị xoá:

  Enum	Giá trị
  AdGroupFormat	AD_GROUP_FORMAT_ACTION

• Các giá trị enum sau đây đã được thêm:

  Enum	Giá trị
  AdGroupFormat	AD_GROUP_FORMAT_RESPONSIVE
  SdfVersion	SDF_VERSION_7

phiên bản 2

• Các giá trị enum sau đây đã được thêm:

  Enum	Giá trị
  SdfVersion	SDF_VERSION_7

Ngày 2 tháng 10 năm 2023

Tính năng mới

Phát hành phiên bản 3 ở giai đoạn thử nghiệm công khai, bao gồm những thay đổi sau:

• Khả năng quản lý hoàn toàn danh sách vị trí lân cận, cho phép sử dụng dịch vụ advertisers.locationLists.assignedLocations để tạo và xoá các vị trí được chỉ định cho tài nguyên TARGETING_LOCATION_TYPE_PROXIMITY LocationList.
• Một trường boolean mới enableOptimizedTargeting, thay thế trường targetingExpansionLevel trong đối tượng TargetingExpansionConfig.
• Yêu cầu về trường billingConfig trong tài nguyên Advertiser. Bạn phải thêm trường này khi đưa ra yêu cầu advertisers.create và trường billingConfig mới trong tài nguyên Partner.
• Tài nguyên AdGroup và AdGroupAd mới thay thế tài nguyên YoutubeAdGroup và YoutubeAdGroupAd trong phiên bản 2.

Làm theo các bước trong hướng dẫn di chuyển của chúng tôi để di chuyển từ phiên bản 2 sang phiên bản 3.

Thêm chế độ hỗ trợ cho 3 giá trị LineItemType mới, một giá trị YoutubeAndPartnersBiddingStrategyType mới và một giá trị PartnerCostType mới trong phiên bản 2 và phiên bản 3.

v3

• Các phương thức sau đã được thêm:

  Dịch vụ	Phương thức
  advertisers.adGroupAds	get list
  advertisers.adGroups	bulkListAdGroupAssignedTargetingOptions get list
  advertisers.adGroups.targetingTypes.assignedTargetingOptions	get list
  customBiddingAlgorithms	uploadRules
  customBiddingAlgorithms.rules	create get list

• Các phương thức sau đây đã bị xoá:

  Dịch vụ	Phương thức
  advertisers.manualTriggers	kích hoạt create hủy kích hoạt get danh sách bản vá
  advertisers.youtubeAdGroupAds	get danh sách
  advertisers.youtubeAdGroups	bulkListAdGroupAssignedTargetingOptions get danh sách
  advertiser.youtubeAdGroups.targetingTypes.assignedTargetingOptions	get danh sách

• Hành vi của phương thức sau đây đã thay đổi:

  Phương thức	Thay đổi
  advertisers.locationLists.create	Hiện hỗ trợ việc tạo tài nguyên TARGETING_LOCATION_TYPE_PROXIMITY LocationList.
  advertisers.locationLists.patch	Hiện hỗ trợ cập nhật tài nguyên TARGETING_LOCATION_TYPE_PROXIMITY LocationList.
  advertisers.locationLists.assignedLocations.bulkEdit	Hiện hỗ trợ chỉnh sửa hàng loạt tài nguyên AssignedLocation trong tài nguyên TARGETING_LOCATION_TYPE_PROXIMITY LocationList.
  advertisers.locationLists.assignedLocations.create	Hiện hỗ trợ việc tạo tài nguyên AssignedLocation trong tài nguyên TARGETING_LOCATION_TYPE_PROXIMITY LocationList.

• Các tham số truy vấn sau đây đã được thêm:

  Phương thức	(Các) tham số
  inventorySources.get	advertiserId

• Các trường sau đây đã được đặt là bắt buộc:

  Tài nguyên	(Các) trường
  Nhà quảng cáo	billingConfig

• Các trường sau đã được thêm:

  Tài nguyên	(Các) trường
  BiddingStrategy	youtubeAndPartnersBid
  InsertionOrder	kpi
  Đối tác	billingConfig
  TargetingExpansionConfig	audienceExpansionLevel audienceExpansionSeedListExcluded enableOptimizedTargeting
  YoutubeAndPartnersSettings	thirdPartyMeasurementConfigs
  YoutubeAndPartnersInventorySourceConfig	includeYoutube

• Các trường sau đây đã bị xoá:

  Tài nguyên	(Các) trường
  InsertionOrder	performanceGoal billableOutcome
  TargetingExpansionConfig	excludeFirstPartyAudience targetingExpansionLevel
  YoutubeAndPartnersSettings	biddingStrategy thirdPartyMeasurementSettings
  YoutubeAndPartnersInventorySourceConfig	includeYoutubeSearch includeYoutubeVideos

• Các giá trị enum sau đây đã được thêm:

  Enum	Giá trị
  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

• Các giá trị enum sau đây đã bị xoá:

  Enum	Giá trị
  LineItemWarningMessage	DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

phiên bản 2

• Các giá trị enum sau đây đã được thêm:

  Enum	Giá trị
  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

Ngày 25 tháng 8 năm 2023

Tính năng mới

Thêm chế độ hỗ trợ cho 2 sàn giao dịch và 2 loại chiến lược giá thầu mới trên YouTube và Mạng đối tác.

Đã thêm một trường effectiveContentCategory mới vào mục hàng YouTube và đối tác để hiển thị YoutubeAndPartnersContentCategory mà mục hàng sử dụng khi xem xét các giá trị được chỉ định ở cả cấp nhà quảng cáo và mục hàng.

phiên bản 2

• Các trường sau đã được thêm:

  Tài nguyên	(Các) trường
  YoutubeAndPartnersSettings	effectiveContentCategory

• Các trường sau đây đã bị xoá:

  Tài nguyên	(Các) trường
  InventorySource	subSitePropertyId

• Các giá trị enum sau đây đã được thêm:

  Enum	Giá trị
  Exchange	EXCHANGE_HIVESTACK EXCHANGE_RESET_DIGITAL
  YoutubeAndPartnersBiddingStrategyType	YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS

Ngày 5 tháng 6 năm 2023

Tính năng mới

Thêm giá trị SdfVersion mới cho Tệp dữ liệu có cấu trúc (SDF) phiên bản 6 trong phiên bản 1 và phiên bản 2.

phiên bản 2

• Các giá trị enum sau đây đã được thêm:

  Enum	Giá trị
  SdfVersion	SDF_VERSION_6

v1

• Các giá trị enum sau đây đã được thêm:

  Enum	Giá trị
  SdfVersion	SDF_VERSION_6

Ngày 9 tháng 3 năm 2023

Tính năng mới

Đã thêm giá trị LineItemWarningMessage mới sẽ được chỉ định cho trường warningMessages của một mục hàng nếu trường này có trường excludeFirstPartyAudience không dùng nữa được đặt thành true. Trường excludeFirstPartyAudience sẽ ngừng hoạt động và được đặt thành false sau ngày 25 tháng 3 năm 2023.

phiên bản 2

• Các giá trị enum sau đây đã được thêm:

  Enum	Giá trị
  LineItemWarningMessage	DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

v1

• Các giá trị enum sau đây đã được thêm:

  Enum	Giá trị
  LineItemWarningMessage	DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

Ngày 8 tháng 2 năm 2023

Tính năng mới

Thêm khả năng truy xuất tài nguyên YouTubeAdGroup và YouTubeAdGroupAd, cũng như tiêu chí nhắm mục tiêu của tài nguyên Nhóm quảng cáo trên YouTube. Ngoài ra, chúng tôi cũng đã thêm các loại tiêu chí nhắm mục tiêu mới có thể truy xuất được dùng ở cấp Nhóm quảng cáo trên YouTube. Hãy đọc trang hướng dẫn mới của chúng tôi về cách truy xuất tài nguyên của YouTube và Đối tác để biết thêm thông tin.

Đã thêm tính năng hỗ trợ cho 4 sàn giao dịch khác trong phiên bản 1 và phiên bản 2.

phiên bản 2

• Các phương thức sau đã được thêm:

  Dịch vụ	Phương thức
  advertisers.youtubeAdGroupAds	get list
  advertisers.youtubeAdGroups	bulkListAdGroupAssignedTargetingOptions get list
  advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions	get list

• Các trường sau đã được thêm:

  Dịch vụ	Phương thức
  AssignedTargetingOption	sessionPositionDetails youtubeChannelDetails youtubeVideoDetails
  YoutubeAndPartnersSettings	leadFormId linkedMerchantId relatedVideoIds targetFrequency videoAdSequenceSettings

• Các giá trị enum sau đây đã được thêm:

  Enum	Giá trị
  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

• Các giá trị enum sau đây đã được thêm:

  Enum	Giá trị
  Exchange	EXCHANGE_APPLOVIN EXCHANGE_CONNATIX EXCHANGE_JCD EXCHANGE_PLACE_EXCHANGE

Ngày 6 tháng 12 năm 2022

Tính năng mới

Chuyển phiên bản 2 từ giai đoạn thử nghiệm công khai sang giai đoạn phát hành rộng rãi.

Đã thêm một trường assignedTargetingOptionIdAlias mới vào tài nguyên AssignedTargetingOption. Trường này có thể được dùng thay cho assignedTargetingOptionId khi truy xuất và xoá tiêu chí nhắm mục tiêu. Trường này chỉ được đặt cho các tiêu chí nhắm mục tiêu được chỉ định của các loại tiêu chí nhắm mục tiêu được chỉ định thông qua enum. Giá trị bí danh là giá trị enum có liên quan dưới dạng một chuỗi.

Đã thêm một trường billingConfig mới vào tài nguyên Advertiser.

Đã thêm tính năng hỗ trợ truy xuất các mục riêng của YouTube và Đối tác, được xác định bằng 3 giá trị LineItemType mới.

Tăng kích thước trang tối đa lên 200 cho nhiều phương thức list trong phiên bản 1 và 2. Kích thước trang mặc định không thay đổi.

phiên bản 2

• Các trường sau đã được thêm:

  Tài nguyên	(Các) trường
  Nhà quảng cáo	billingConfig
  AssignedTargetingOption	assignedTargetingOptionIdAlias

• Các giá trị enum sau đây đã được thêm:

  Enum	Giá trị
  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

• Kích thước trang tối đa đã được tăng lên cho các phương thức danh sách sau:

  Phương thức	Kích thước trang tối đa mới
  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

• Kích thước trang tối đa đã được tăng lên cho các phương thức danh sách sau:

  Phương thức	Kích thước trang tối đa mới
  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

Vấn đề đã biết

Bản cập nhật này khắc phục các vấn đề đã biết sau đây trong phiên bản 2:

• Không thể xoá hoặc truy xuất các lựa chọn nhắm mục tiêu được chỉ định của các loại tiêu chí nhắm mục tiêu được chỉ định bằng cách sử dụng các giá trị enum trong phiên bản 2 bằng assignedTargetingOptionId và thay vào đó, người dùng dự kiến sẽ sử dụng giá trị enum. Với bản cập nhật này, bạn có thể xoá hoặc truy xuất các lựa chọn nhắm mục tiêu được chỉ định này bằng cách sử dụng assignedTargetingOptionId hoặc giá trị enum, được xác định bằng trường assignedTargetingOptionIdAlias mới trong tài nguyên AssignedTargetingOption.
• Yêu cầu bulkUpdate mục hàng đã không sử dụng đúng tham số yêu cầu advertisersId, dẫn đến lỗi. Với bản cập nhật này, phương thức đã được sửa và tham số yêu cầu đã được đổi tên từ advertisersId thành advertiserId.

Ngày 27 tháng 10 năm 2022

Thêm chức năng sao chép một mục hàng hiện có trong InsertionOrder gốc.

Giới thiệu tính năng hỗ trợ ghi nhắm mục tiêu theo đơn đặt hàng quảng cáo một phần cho một số loại tiêu chí nhắm mục tiêu bằng cách thêm các phương thức create và delete vào dịch vụ advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.

Tính năng mới

phiên bản 2

• Các phương thức sau đã được thêm:

  Dịch vụ	Phương thức
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions	create xóa
  advertisers.lineItems	duplicate

v1

Chưa có tính năng mới nào được thêm vào phiên bản 1.

Ngày 20 tháng 9 năm 2022

Phát hành phiên bản 2 ở giai đoạn thử nghiệm công khai, bao gồm những thay đổi sau:

• Khả năng truy xuất các mục hàng của YouTube và Đối tác cũng như chế độ cài đặt nhắm mục tiêu của các mục hàng đó bằng cách sử dụng phương thức get và list trong các dịch vụ advertisers.lineItems và advertisers.lineItems.targetingTypes.assignedTargetingOptions .
• Hai phương thức nhắm mục tiêu hàng loạt mới trong dịch vụ advertisers.lineItems cho phép chỉnh sửa và truy xuất tiêu chí nhắm mục tiêu được chỉ định trên nhiều mục hàng bằng một yêu cầu duy nhất.
• Một phương thức bulkUpdate mới cho phép người dùng cập nhật entityStatus của nhiều mục hàng trong một yêu cầu.
• Logic nhắm mục tiêu mới yêu cầu phải chỉ định và truy xuất AssignedTargetingOption tài nguyên của một nhóm nhỏ các loại tiêu chí nhắm mục tiêu bằng cách sử dụng các giá trị enum thay vì mã nhận dạng lựa chọn nhắm mục tiêu được truy xuất bằng dịch vụ targetingTypes.targetingOptions.

Hãy làm theo các bước trong hướng dẫn di chuyển của chúng tôi để di chuyển từ phiên bản 1 sang phiên bản 2.

Thêm tính năng hỗ trợ cho 3 sàn giao dịch mới trong phiên bản 1.

Tính năng mới

phiên bản 2

Sau đây là danh sách các thay đổi giữa phiên bản 1 và phiên bản 2:

• Các phương thức sau đã được thêm vào phiên bản 2:

  Dịch vụ	Phương thức
  advertisers.lineItems	bulkEditAssignedTargetingOptions bulkListAssignedTargetingOptions bulkUpdate

• Các phương thức sau đã bị xoá trong phiên bản 2:

  Dịch vụ	Phương thức
  advertisers.lineItems	bulkEditLineItemAssignedTargetingOptions bulkListLineItemAssignedTargetingOptions

• Các phương thức sau đây đã được đổi tên trong phiên bản 2:

  Dịch vụ	Tên phương thức cũ	Tên phương thức mới
  nhà quảng cáo	bulkEditAdvertiserAssignedTargetingOptions bulkListAdvertiserAssignedTargetingOptions	editAssignedTargetingOptions listAssignedTargetingOptions
  advertisers.campaigns	bulkListCampaignAssignedTargetingOptions	listAssignedTargetingOptions
  advertisers.insertionOrders	bulkListInsertionOrderAssignedTargetingOptions	listAssignedTargetingOptions
  partners	bulkEditPartnerAssignedTargetingOptions	editAssignedTargetingOptions

• Tài nguyên AssignedTargetingOption của các loại tiêu chí nhắm mục tiêu sau đây sử dụng enum để chỉ định tiêu chí nhắm mục tiêu trong phiên bản 2. Trường assignedTargetingOptionId cho tài nguyên AssignedTargetingOption của các loại tiêu chí nhắm mục tiêu này cũng đã được cập nhật trong phiên bản 2 để sử dụng các phiên bản chuỗi của giá trị enum:

  Loại nhắm mục tiêu	Loại 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	Môi trường
  TARGETING_TYPE_EXCHANGE	Exchange
  TARGETING_TYPE_GENDER	Giới tính
  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	Khả năng xem

• Các trường sau đã được thêm vào phiên bản 2:

  Tài nguyên	(Các) trường
  CustomBiddingAlgorithm	modelDetails
  DeviceTypeAssignedTargetingOptionDetails	youtubeAndPartnersBidMultiplier
  DigitalContentLabelAssignedTargetingOptionDetails	excludedContentRatingTier
  ExchangeAssignedTargetingOptionDetails	exchange
  FrequencyCap	maxViews
  LineItem	youtubeAndPartnersSettings
  ProximityLocationListAssignedTargetingOptionDetails	proximityRadius proximityRadiusUnit
  SensitiveCategoryAssignedTargetingOptionDetails	excludedSensitiveCategory

• Các trường sau đây đã bị xoá trong phiên bản 2:

  Tài nguyên	(Các) trường
  AgeRangeAssignedTargetingOptionDetails	targetingOptionId
  ContentInstreamPositionAssignedTargetingOptionDetails	targetingOptionId
  ContentOutstreamPositionAssignedTargetingOptionDetails	targetingOptionId
  CustomBiddingAlgorithm	customBiddingAlgorithmState
  DeviceTypeAssignedTargetingOptionDetails	targetingOptionId
  DigitalContentLabelAssignedTargetingOptionDetails	contentRatingTier excludedTargetingOptionId
  EnvironmentAssignedTargetingOptionDetails	targetingOptionId
  ExchangeAssignedTargetingOptionDetails	targetingOptionId
  GenderAssignedTargetingOptionDetails	targetingOptionId
  HouseholdIncomeAssignedTargetingOptionDetails	targetingOptionId
  LineItem	inventorySourceIds
  LineItemFlight	triggerId
  NativeContentPositionAssignedTargetingOptionDetails	targetingOptionId
  OmidAssignedTargetingOptionDetails	targetingOptionId
  ParentalStatusAssignedTargetingOptionDetails	targetingOptionId
  ProximityLocationListAssignedTargetingOptionDetails	proximityRadiusRange
  SensitiveCategoryAssignedTargetingOptionDetails	excludedTargetingOptionId sensitiveCategory
  VideoPlayerSizeAssignedTargetingOptionDetails	targetingOptionId
  ViewabilityAssignedTargetingOptionDetails	targetingOptionId

• Các trường sau đây đã được chuyển thành trường bắt buộc trong phiên bản 2:

  Tài nguyên	(Các) trường
  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	khả năng xem

• Các giá trị enum sau đây đã được thêm vào phiên bản 2:

  Enum	Giá trị
  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

• Các giá trị enum sau đây đã bị xoá trong phiên bản 2:

  Enum	Giá trị
  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

• Các giá trị enum sau đây đã được thêm vào phiên bản 1:

  Enum	Giá trị
  Exchange	EXCHANGE_DAX EXCHANGE_FYBER EXCHANGE_VISTAR

Ngày 26 tháng 5 năm 2022

Thêm khả năng tạo tài nguyên InventorySource và quản lý tài nguyên GuaranteedOrder thông qua các phương thức ghi dịch vụ inventorySources mới và dịch vụ guaranteedOrders mới.

Ra mắt trường modelReadiness trong tài nguyên CustomBiddingAlgorithm. Trường này liệt kê mức độ sẵn sàng của mô hình thuật toán cho từng nhà quảng cáo có thể truy cập vào mô hình đó.

Đã bật chức năng tham số truy vấn filter mới cho phương thức advertisers.creatives.list. Chức năng này cho phép người dùng chỉ truy xuất mẫu quảng cáo có updateTime trước hoặc sau một dấu thời gian nhất định.

Đã thêm hỗ trợ cho phiên bản SDF mới nhất, v5.5, thông qua việc thêm giá trị enum SdfVersion.

Tính năng mới

• Các phương thức sau đã được thêm:

  Dịch vụ	Phương thức
  guaranteedOrders	create editGuaranteedOrderReadAccessors get list patch
  inventorySources	create editInventorySourceReadWriteAccessors patch

• Các trường sau đã được thêm:

  Tài nguyên	(Các) trường
  CustomBiddingAlgorithm	modelReadiness
  InventorySource	inventorySourceProductType guaranteedOrderId readAdvertiserIds readPartnerIds readWriteAccessors

• Các giá trị enum sau đây đã được thêm:

  Enum	Giá trị
  SdfVersion	SDF_VERSION_5_5

• Giờ đây, bạn có thể lọc các phương thức danh sách sau đây theo các thuộc tính sau:

  Phương thức	(Các) trường
  advertisers.creatives.list	updateTime

Ngày 31 tháng 3 năm 2022

Thêm tính năng hỗ trợ truy xuất và thiết lập tiêu chí nhắm mục tiêu theo thời lượng nội dung, loại luồng phát và thể loại.

Đã thêm trường billableOutcome vào đối tượng InsertionOrder.

Giới thiệu trường raiseBidForDeals cho đối tượng MaximizeSpendBidStrategy, cho phép người dùng đặt xem chiến lược đặt giá thầu có áp dụng giá sàn của nhà quảng cáo cho các giao dịch được nhắm mục tiêu hay không.

Tính năng mới

• Các trường sau đã được thêm:

  Tài nguyên	(Các) trường
  AssignedTargetingOption	contentDurationDetails contentGenreDetails contentStreamTypeDetails
  InsertionOrder	billableOutcome
  MaximizeSpendBidStrategy	raiseBidForDeals
  TargetingOption	contentDurationDetails contentGenreDetails contentStreamTypeDetails

• Các giá trị enum sau đây đã được thêm:

  Enum	Giá trị
  TargetingType	TARGETING_TYPE_CONTENT_DURATION TARGETING_TYPE_CONTENT_GENRE TARGETING_TYPE_CONTENT_STREAM_TYPE

Ngày 2 tháng 2 năm 2022

Bổ sung tính năng hỗ trợ để tạo, cập nhật và chỉnh sửa thành viên của một số tài nguyên FirstAndThirdPartyAudience So khớp khách hàng. Trang Tải đối tượng So khớp khách hàng lên trong hướng dẫn mới của chúng tôi về Sử dụng đối tượng trình bày chi tiết cách sử dụng những tính năng mới này.

Giới thiệu một trường reservationType mới trong InsertionOrder và LineItem tài nguyên để xác định xem một tài nguyên có phải là Tag Guaranteed, Programmatic Guaranteed hay không.

Thêm khả năng truy xuất và đặt xem một mục hàng có tự động nhắm đến các sàn giao dịch mới thông qua một trường excludeNewExchanges mới hay không.

Ngoài các tính năng mới, hạn mức mặc định cũng đã tăng gấp đôi.

Tính năng mới

• Các phương thức sau đã được thêm:

  Dịch vụ	Phương thức
  firstAndThirdPartyAudiences	create editCustomerMatchMembers patch

• Các trường sau đã được thêm:

  Tài nguyên	(Các) trường
  FirstAndThirdPartyAudience	appId contactInfoList mobileDeviceIdList
  InsertionOrder	reservationType
  LineItem	excludeNewExchanges reservationType

Ngày 8 tháng 12 năm 2021

Đã thêm chế độ hỗ trợ cho tiêu chí nhắm mục tiêu theo loại nội dung âm thanh trong loại tiêu chí nhắm mục tiêu TARGETING_TYPE_AUDIO_CONTENT_TYPE.

Tính năng mới

• Các trường sau đã được thêm:

  Tài nguyên	(Các) trường
  AssignedTargetingOption	audioContentTypeDetails
  TargetingOption	audioContentTypeDetails

• Các giá trị enum sau đây đã được thêm:

  Enum	Giá trị
  TargetingType	TARGETING_TYPE_AUDIO_CONTENT_TYPE

Ngày 8 tháng 11 năm 2021

Thêm tính năng hỗ trợ đầy đủ cho việc quản lý thuật toán đặt giá thầu tuỳ chỉnh và tập lệnh của thuật toán đó. Nội dung như vậy bao gồm:

• Các hàm để tạo customBiddingAlgorithms mới và cập nhật customBiddingAlgorithms hiện có.
• Khả năng tải tập lệnh lên thông qua quy trình truy xuất vị trí tài nguyên có sẵn, sau đó tải tệp lên vị trí đó.
• Một dịch vụ customBiddingAlgorithms.scripts mới để truy xuất và tạo customBiddingScripts.

Chúng tôi đã thêm một trang mới có tên Triển khai tính năng Đặt giá thầu tuỳ chỉnh vào hướng dẫn Quản lý mục hàng. Trang này mô tả quy trình tạo thuật toán đặt giá thầu tuỳ chỉnh, tải tập lệnh lên và chỉ định thuật toán đặt giá thầu tuỳ chỉnh làm chiến lược đặt giá thầu của mục hàng.

Đã thêm chế độ hỗ trợ cho phiên bản SDF mới nhất, v5.4, thông qua việc thêm giá trị enum SdfVersion.

Tính năng mới

• Các phương thức sau đã được thêm:

  Dịch vụ	Phương thức
  customBiddingAlgorithms	create patch uploadScript
  customBiddingAlgorithms.scripts	create get list
  media	upload

• Các giá trị enum sau đây đã được thêm:

  Enum	Giá trị
  SdfVersion	SDF_VERSION_5_4

Ngày 14 tháng 9 năm 2021

Thêm tính năng hỗ trợ nhắm mục tiêu theo khoảng cách trong các loại tiêu chí nhắm mục tiêu TARGETING_TYPE_BUSINESS_CHAIN và TARGETING_TYPE_POI.

Thêm chức năng tìm kiếm các lựa chọn nhắm mục tiêu TARGETING_TYPE_BUSINESS_CHAIN và TARGETING_TYPE_POI hiện có bằng cách sử dụng targetingTypes.targetingOptions.search, vì các lựa chọn này không thể truy xuất thông qua các phương thức targetingTypes.targetingOptions.get hoặc targetingTypes.targetingOptions.list.

Giới thiệu các trường sharedAdvertiserIds và customBiddingAlgorithmState mới cho tài nguyên Thuật toán đặt giá thầu tuỳ chỉnh, đồng thời thêm chế độ hỗ trợ cho loại thuật toán đặt giá thầu tuỳ chỉnh GOAL_BUILDER_BASED.

Thêm 2 giá trị mới vào enum Exchange.

Tính năng mới

• Các trường sau đã được thêm:

  Tài nguyên	(Các) trường
  AssignedTargetingOption	businessChainDetails poiDetails
  CustomBiddingAlgorithm	customBiddingAlgorithmState sharedAdvertiserIds
  TargetingOption	businessChainDetails poiDetails
  Nội dung yêu cầu TargetingOptions.search	businessChainSearchTerms poiSearchTerms

• Các giá trị enum sau đây đã được thêm:

  Enum	Giá trị
  CustomBiddingAlgorithmType	GOAL_BUILDER_BASED
  Exchange	EXCHANGE_RED_FOR_PUBLISHERS EXCHANGE_TAPJOY
  TargetingType	TARGETING_TYPE_BUSINESS_CHAIN TARGETING_TYPE_POI

• Giờ đây, bạn có thể lọc các phương thức danh sách sau đây theo các thuộc tính sau:

  Phương thức	(Các) trường
  customBiddingAlgorithms.list	customBiddingAlgorithmState

Ngày 4 tháng 8 năm 2021

Thêm chế độ hỗ trợ cho tiêu chí nhắm mục tiêu khoảng không quảng cáo có bật tính năng Đo lường mở trong loại tiêu chí nhắm mục tiêu TARGETING_TYPE_OMID.

Tăng số lượng tối đa các lựa chọn nhắm mục tiêu được chỉ định có thể được trả về trong một trang duy nhất của nhiều phương thức danh sách lựa chọn nhắm mục tiêu được chỉ định nhà quảng cáo, chiến dịch, đơn đặt hàng quảng cáo và mục hàng bằng cách sử dụng tham số phương thức pageSize.

Tính năng mới

• Các trường sau đã được thêm:

  Tài nguyên	(Các) trường
  AssignedTargetingOption	omidDetails
  TargetingOption	omidDetails

• Các giá trị enum sau đây đã được thêm:

  Enum	Giá trị
  TargetingType	TARGETING_TYPE_OMID

• Kích thước trang tối đa đã được tăng lên cho các phương thức danh sách sau:

  Phương thức	Kích thước trang tối đa mới
  advertisers.campaigns.targetingTypes.assignedTargetingOptions.list	5000
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.list	5000
  advertisers.lineItems.targetingTypes.assignedTargetingOptions.list	5000
  advertisers.targetingTypes.assignedTargetingOptions.list	5000

Ngày 26 tháng 5 năm 2021

Ra mắt dịch vụ advertisers.invoices, cho phép người dùng:

• truy xuất hoá đơn được phát hành cho một nhà quảng cáo trong một tháng nhất định.
• tra cứu mã đơn vị tiền tệ mà nhà quảng cáo sử dụng trong một tháng nhất định.

Đã thêm trường campaignBudgets vào tài nguyên chiến dịch. Bạn có thể liên kết các phân khúc ngân sách của đơn đặt hàng quảng cáo với ngân sách chiến dịch, giới hạn tổng ngân sách của các phân khúc được liên kết theo tổng số tiền ngân sách của chiến dịch.

Đã thêm tính năng hỗ trợ cho tiêu chí nhắm mục tiêu theo vị trí nội dung gốc trong loại tiêu chí nhắm mục tiêu mới TARGETING_TYPE_NATIVE_CONTENT_POSITION.

Giới thiệu một trường prismaEnabled mới cho tài nguyên nhà quảng cáo, cho phép người dùng bật chế độ tích hợp với công cụ Prisma của Mediaocean.

Đã bật chế độ hỗ trợ cho giá trị enum ENTITY_STATUS_PAUSED cho trường entityStatus của Nhà quảng cáo.

Tính năng mới

• Các phương thức sau đã được thêm:

  Dịch vụ	Phương thức
  advertisers.invoices	list lookupInvoiceCurrency

• Các trường sau đã được thêm:

  Tài nguyên	(Các) trường
  Nhà quảng cáo	prismaEnabled
  AssignedTargetingOption	nativeContentPositionDetails
  Chiến dịch	campaignBudgets
  TargetingOption	nativeContentPositionDetails

• Các giá trị enum sau đây đã được thêm:

  Enum	Giá trị
  AssignedTargetingOption.Recency	RECENCY_45_DAYS
  Exchange	EXCHANGE_MEDIANET
  TargetingType	TARGETING_TYPE_NATIVE_CONTENT_POSITION

• Các giá trị liệt kê sau đây hiện hợp lệ cho các trường sau:

  Tài nguyên	Trường	Giá trị
  Nhà quảng cáo	entityStatus	ENTITY_STATUS_PAUSED

Ngày 29 tháng 4 năm 2021

Đã thêm các trường mới vào tài nguyên Kênh và Danh sách từ khoá phủ định để trả về số lượng mục dòng sử dụng tài nguyên để nhắm mục tiêu. Đã bật các thuộc tính filter mới cho phương thức danh sách mục hàng. Các thuộc tính này chỉ cho phép người dùng truy xuất những mục hàng đang sử dụng các kênh hoặc danh sách từ khoá phủ định cụ thể trong tiêu chí nhắm mục tiêu.

Tính năng mới

• Các trường sau đã được thêm:

  Tài nguyên	(Các) trường
  Kênh	negativelyTargetedLineItemCount positivelyTargetedLineItemCount
  NegativeKeywordList	targetedLineItemCount

• Giờ đây, bạn có thể lọc các phương thức danh sách sau đây theo các thuộc tính sau:

  Phương thức	(Các) trường
  advertisers.lineItems.list	targetedChannelId targetedNegativeKeywordListId

Ngày 30 tháng 3 năm 2021

Đã thêm phương thức mới vào dịch vụ mục hàng để tạo mục hàng có cấu hình mặc định. Các giá trị mặc định này dựa trên loại mục hàng đã cho, cũng như các chế độ cài đặt và tiêu chí nhắm mục tiêu được chỉ định của đơn đặt hàng quảng cáo mẹ.

Cho phép truy xuất tiêu chí nhắm mục tiêu của chiến dịch thông qua dịch vụ nhắm mục tiêu mới của chiến dịch và phương thức danh sách hàng loạt bổ sung.

Mở rộng tiêu chí nhắm mục tiêu theo ứng dụng để cho phép nhắm mục tiêu đến các ứng dụng trên nhiều nền tảng hơn.

Thực hiện nhiều thay đổi đối với các dịch vụ advertisers.channels.sites, partners.channels.sites và advertisers.negativeKeywordLists.negativeKeywords để giúp bạn quản lý nội dung danh sách kênh và danh sách từ khoá phủ định dễ dàng hơn. Những thay đổi này bao gồm:

• Việc bổ sung các phương thức replace, cho phép người dùng ghi đè hoàn toàn nội dung hiện có của một kênh hoặc danh sách từ khoá phủ định.
• Việc xóa bỏ yêu cầu rằng không có mục nào hiện có được đưa vào trường createdSites hoặc createdNegativeKeywords của yêu cầu chỉnh sửa hàng loạt.
• Số lượng tối đa các mục có thể được trả về trên một trang của phản hồi list sites hoặc list negative keywords.

Tính năng mới

• Các phương thức sau đã được thêm:

  Dịch vụ	Phương thức
  advertisers.campaigns	bulkListCampaignAssignedTargetingOptions
  advertisers.campaigns.targetingTypes.assignedTargetingOptions	get list
  advertisers.channels.sites	thay thế
  advertisers.lineItems	generateDefault
  advertisers.negativeKeywordLists.negativeKeywords	thay thế
  partners.channels.sites	thay thế

• Các trường sau đã được thêm:

  Tài nguyên	(Các) trường
  AssignedTargetingOption.AppAssignedTargetingOptionDetails	appPlatform

• Kích thước trang tối đa đã được tăng lên cho các phương thức danh sách sau:

  Phương thức	Kích thước tối đa của trang cũ	Kích thước trang tối đa mới
  advertisers.channels.sites.list	100	10000
  advertisers.negativeKeywordLists.negativeKeywords.list	100	1000
  partners.channels.sites.list	100	10000

Ngừng sử dụng

• Bạn không thể chỉ định các giá trị enum sau đây cho tài nguyên mới hoặc hiện có nữa:

  Enum	Giá trị
  PartnerRevenueModelMarkupType	PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP

Ngày 24 tháng 2 năm 2021

Ra mắt dịch vụ nhắm mục tiêu theo đơn đặt hàng quảng cáo mới và phương thức danh sách hàng loạt bổ sung cho phép truy xuất tiêu chí nhắm mục tiêu được chỉ định cho đơn đặt hàng quảng cáo. Mở rộng tài nguyên mẫu quảng cáo, thêm các trường mẫu quảng cáo chỉ có đầu ra để mẫu quảng cáo âm thanh của bên thứ ba sử dụng. Đã thêm các loại mục tiêu hiệu suất mới để sử dụng theo đơn đặt hàng và tài nguyên chiến dịch.

Tính năng mới

• Các phương thức sau đã được thêm:

  Dịch vụ	Phương thức
  advertisers.insertionOrders	bulkListInsertionOrderAssignedTargetingOptions
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions	get list

• Các trường sau đã được thêm:

  Tài nguyên	(Các) trường
  Mẫu quảng cáo	mp3Audio oggAudio

• Các giá trị enum sau đây đã được thêm:

  Enum	Giá trị
  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

Ngày 27 tháng 1 năm 2021

Cho phép truy xuất và quản lý đơn đặt hàng quảng cáo trên truyền hình và mục hàng trực tiếp qua Internet thông qua việc giới thiệu trường InsertionOrderType mới và giá trị enum LineItemType mới. Thêm tính năng hỗ trợ cho các mục hàng ứng dụng di động thông qua trường mục hàng mobileApp. Mở rộng khả năng hỗ trợ exchange, đối tượng của Google và SDF thông qua các giá trị enum bổ sung. Ra mắt khả năng lọc và sắp xếp các giá trị advertisers.list theo thời gian cập nhật gần đây nhất.

Tính năng mới

• Các trường sau đã được thêm:

  Tài nguyên	(Các) trường
  InsertionOrder	insertionOrderType
  LineItem	mobileApp

• Các giá trị enum sau đây đã được thêm:

  Enum	Giá trị
  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

• Giờ đây, bạn có thể sắp xếp và lọc các phương thức danh sách sau theo các trường sau:

  Phương thức	(Các) trường
  nhà quảng cáo	updateTime

Ngày 4 tháng 12 năm 2020

Thêm khả năng tìm kiếm các lựa chọn nhắm mục tiêu Khu vực địa lý và lọc nhiều kết quả phương thức danh sách tài nguyên theo thời gian cập nhật gần đây nhất. Giới thiệu LineItemWarningMessage mới để thông báo cho người dùng về thời điểm một mục hàng đang sử dụng tiêu chí nhắm mục tiêu theo vị trí địa lý không được dùng nữa.

Tính năng mới

• Các phương thức sau đã được thêm:

  Dịch vụ	Phương thức
  targetingTypes.targetingOptions	search

• Các giá trị enum sau đây đã được thêm:

  Enum	Giá trị
  Exchange	EXCHANGE_SUPERSHIP
  LineItemWarningMessage	TARGETING_DEPRECATED_GEO_TARGET

• Giờ đây, bạn có thể sắp xếp và lọc các phương thức danh sách sau theo các trường sau:

  Phương thức	(Các) trường
  advertisers.campaigns.list	updateTime
  advertisers.insertionOrders.list	updateTime
  advertisers.lineItems.list	updateTime

Ngày 5 tháng 11 năm 2020

Thêm khả năng tạo, chỉ định và kích hoạt trình kích hoạt thủ công để bắt đầu chi tiêu cho các mục hàng được liên kết. Giới thiệu các lựa chọn mở rộng tiêu chí nhắm mục tiêu. Khi được đặt, các lựa chọn này có thể mở rộng tiêu chí nhắm mục tiêu của một mục hàng để bao gồm những người dùng tương tự như những người dùng trong đối tượng được nhắm mục tiêu. Đã thêm các trường mã nhận dạng phân khúc tuỳ chỉnh vào các đối tượng DoubleVerify và Integral Ad Science được dùng trong tiêu chí nhắm mục tiêu xác minh của bên thứ ba.

Tính năng mới

• Các dịch vụ sau đây đã được thêm:

  Dịch vụ	Phương thức
  advertisers.manualTriggers	activate create huỷ kích hoạt get list patch

• Các trường sau đã được thêm:

  Tài nguyên	(Các) trường
  AssignedTargetingOption.DoubleVerify	customSegmentId
  AssignedTargetingOption.IntegralAdScience	customSegmentId
  LineItem	targetingExpansion
  LineItemFlight	triggerId

• Các giá trị enum sau đây đã được thêm:

  Enum	Giá trị
  LineItemFlightDateType	LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER

• Giờ đây, bạn có thể lọc các phương thức liệt kê sau đây theo các trường sau:

  Phương thức	(Các) trường
  advertisers.lineItems.list	filter.triggerId

Ngày 12 tháng 10 năm 2020

Giới thiệu thông báo cảnh báo có thể truy xuất cho tài nguyên mục hàng và loại mục tiêu hiệu suất tỷ lệ nhấp (CTR). Đã thêm warningMessages làm trường có thể lọc khi liệt kê các mục hàng.

Ngoài các tính năng mới, hạn mức mới hiện đã có hiệu lực và bạn có thể xem tài liệu mới về cách sử dụng yêu cầu hàng loạt.

Tính năng mới

• Các trường sau đã được thêm:

  Tài nguyên	(Các) trường
  LineItem	warningMessages

• Các giá trị enum sau đây đã được thêm:

  Enum	Giá trị
  PerformanceGoalType	PERFORMANCE_GOAL_TYPE_CTR

• Giờ đây, bạn có thể lọc các phương thức liệt kê sau đây theo các trường sau:

  Phương thức	(Các) trường
  advertisers.lineItems.list	warningMessages

Ngày 28 tháng 8 năm 2020

Thêm các trường mới vào nội dung phản hồi của phương thức kiểm tra nhà quảng cáo và các trường có thể lọc mới vào nhiều phương thức danh sách.

Tính năng mới

• Các trường sau đã được thêm:

  Tài nguyên	(Các) trường
  Advertisers.Audit Response Body	adGroupCriteriaCount campaignCriteriaCount channelsCount negativeKeywordListsCount negativelyTargetedChannelsCount

• Giờ đây, bạn có thể lọc các phương thức danh sách sau theo các trường sau:

  Phương thức	(Các) trường
  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

Ngày 4 tháng 8 năm 2020

Ra mắt dịch vụ quản lý người dùng, đối tác và nhắm mục tiêu theo đối tác. Giới thiệu các công cụ giúp người dùng chủ động tránh đạt đến giới hạn thực thể tài khoản. Đã thêm tính năng hỗ trợ cho mục hàng âm thanh và việc sử dụng thuật toán đặt giá thầu tuỳ chỉnh trong mục hàng và chiến lược giá thầu đơn đặt hàng quảng cáo.

Tính năng mới

• Các dịch vụ sau đây đã được thêm:

  Dịch vụ	Phương thức
  customBiddingAlgorithms	get list
  partners	bulkEditPartnerAssignedTargetingOptions get list
  partners.targetingTypes.assignedTargetingOptions	create xoá get list
  người dùng	bulkEditAssignedUserRoles create xoá get list patch

• Các phương thức sau đã được thêm:

  Dịch vụ	Phương thức
  nhà quảng cáo	kiểm tra

• Các trường sau đã được thêm:

  Tài nguyên	(Các) trường
  MaximizeSpendBidStrategy	customBiddingAlgorithmId
  PerformanceGoalBidStrategy	customBiddingAlgorithmId

• Các giá trị enum sau đây đã được thêm:

  Enum	Giá trị
  BiddingStrategyPerformanceGoalType	BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO
  LineItemType	LINE_ITEM_TYPE_AUDIO_DEFAULT

• Giờ đây, bạn có thể sắp xếp và lọc các phương thức danh sách sau theo các trường sau:

  Phương thức	(Các) trường
  advertisers.lineItems.list	flight.dateRange.endDate

• Các phạm vi sau đây đã được thêm để sử dụng cho các dịch vụ sau:

  Phạm vi	Dịch vụ
  https://www.googleapis.com/auth/display-video-user-management	người dùng

Ngày 24 tháng 6 năm 2020

Ra mắt một bản cập nhật nhỏ, bổ sung phương thức tạo cho các kênh đối tác và nhà quảng cáo, các trường FirstAndThirdPartyAudience mới và các giá trị enum exchange bổ sung.

Tính năng mới

• Các dịch vụ sau đây đã được thêm:

  Dịch vụ	Phương thức
  advertisers.channels	create
  partners.channels	create

• Các trường sau đã được thêm:

  Tài nguyên	(Các) trường
  FirstAndThirdPartyAudience	activeDisplayAudienceSize audienceSource audienceType description displayAudienceSize displayDesktopAudienceSize displayMobileAppAudienceSize displayMobileWebAudienceSize gmailAudienceSize membershipDurationDays youtubeAudienceSize

• Các giá trị enum sau đây đã được thêm:

  Enum	Giá trị
  Exchange	EXCHANGE_OPEN8 EXCHANGE_TRITON EXCHANGE_UNRULYX

• Giờ đây, bạn có thể lọc các phương thức danh sách sau theo các trường sau:

  Phương thức	(Các) trường
  advertisers.creatives.list	creativeId

Ngày 2 tháng 6 năm 2020

Ra mắt khả năng tạo, vá và điền sẵn một nhóm nhỏ các thực thể có thể nhắm đến, đồng thời thêm khả năng sửa đổi tiêu chí nhắm mục tiêu ở cấp nhà quảng cáo cho 3 loại tiêu chí nhắm mục tiêu: kênh, tiêu chí loại trừ nhãn nội dung kỹ thuật số và tiêu chí loại trừ danh mục nhạy cảm.

Tính năng mới

• Các dịch vụ sau đây đã được thêm:

  Dịch vụ	Phương thức
  advertisers.channels.sites	bulkEdit create xoá list
  advertisers.locationLists.assignedLocations	bulkEdit create xoá list
  advertisers.negativeKeywordLists.negativeKeywords	bulkEdit create xoá list
  advertisers.targetingTypes.assignedTargetingOptions	create xoá get list
  inventorySourceGroups.assignedInventorySources	bulkEdit create xoá list
  partners.channels.sites	bulkEdit create xoá list

• Các phương thức sau đã được thêm:

  Dịch vụ	Phương thức
  nhà quảng cáo	bulkEditAdvertiserAssignedTargetingOptions bulkListAdvertiserAssignedTargetingOptions
  advertisers.channels	patch
  advertisers.locationLists	create patch
  advertisers.negativeKeywordLists	create xoá patch
  inventorySourceGroups	create xoá patch
  partners.channels	patch

• Các trường sau đã được thêm:

  Tài nguyên	(Các) trường
  nhà quảng cáo	servingConfig
  mẫu quảng cáo	lineItemIds
  insertionOrder.insertionOrderBudgetSegment	campaignBudgetId

Ngày 27 tháng 4 năm 2020

Ra mắt một bộ tính năng lớn, mở rộng phạm vi của API ngoài SDF. Thêm tính năng quản lý tài nguyên cốt lõi cho phép bạn tạo, truy xuất, cập nhật và xoá các thực thể như nhà quảng cáo, chiến dịch, đơn đặt hàng quảng cáo, mục hàng và mẫu quảng cáo. Các chức năng mới cũng cho phép chỉnh sửa tiêu chí nhắm mục tiêu ở cấp mục hàng.

Tính năng mới

Các dịch vụ sau đây đã được thêm:

Dịch vụ	Phương thức
nhà quảng cáo	create xoá get list patch
advertisers.assets	upload
advertisers.campaigns	create xoá get list patch
advertisers.channels	get list
advertisers.creatives	create xoá get list patch
advertisers.insertionOrders	create xoá get list patch
advertisers.lineItems	bulkEditLineItemAssignedTargetingOptions bulkListLineItemAssignedTargetingOptions create xoá get list patch
advertisers.lineItems.targetingTypes.assignedTargetingOptions	create xoá 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

Ngày 9 tháng 3 năm 2020

Ra mắt Display & Video 360 API phiên bản 1. Đây là phiên bản ban đầu của API.

Vấn đề đã biết

Không có.