版本資訊

本頁面提供有效 Google Ad Manager API 版本的版本資訊。為求完整，系統只會顯示部分舊版版本資訊，這些資訊已無法使用。

• 最新版本：v202508
• 舊版：v202505、v202502、v202411

v202508

新功能

影片

• 已新增 MimeType.VIDEO_MP2T。

委刊項

• 已新增 CostType.CPCV 。
• 已新增 UnitType.COMPLETED_VIEWS 。

API 變更

1. = AdRuleService (無變更)
2. ≠ AdjustmentService (0 new, 2 changed, 0 removed)
   1. ≠ enum DateTimeRangeTargetingError.Reason
      1. + 值 BLACKOUT_DURATION_TOO_SHORT
   2. ≠ enum ForecastAdjustmentError.Reason
      1. − value PARENT_SEGMENT_TARGETING_INCOMPATIBLE_WITH_HISTORICAL_BASIS_AD_REQUEST_SOURCE_SETTINGS
3. = AdsTxtService (無變更)
4. = AudienceSegmentService (no changes)
5. = CdnConfigurationService (無變更)
6. = CmsMetadataService (無變更)
7. = CompanyService (沒有變更)
8. = ContactService (no changes)
9. = ContentBundleService (無變更)
10. ≠ ContentService (0 new, 2 changed, 0 removed)
    1. ≠ enum MimeType
       1. + 值 VIDEO_MP2T
    2. ≠ enum VodIngestError
       1. + value CHAPTER_PTS_MISMATCH
       2. + value CHAPTER_RENDITION_ERROR
11. ≠ CreativeService (0 個新增、2 個變更、0 個移除)
    1. ≠ type Creative
       1. + 欄位 selfDeclaredEuropeanUnionPoliticalContent
    2. ≠ enum MimeType
       1. + 值 VIDEO_MP2T
12. = CreativeSetService (無變更)
13. = CreativeTemplateService (無變更)
14. = CreativeWrapperService (no changes)
15. = CustomFieldService (無變更)
16. = CustomTargetingService (no changes)
17. = DaiAuthenticationKeyService (no changes)
18. = DaiEncodingProfileService (無變更)
19. ≠ ForecastService (0 new, 4 changed, 0 removed)
    1. ≠ enum CostType
       1. + 價值 CPCV
    2. ≠ enum DateTimeRangeTargetingError.Reason
       1. + 值 BLACKOUT_DURATION_TOO_SHORT
    3. ≠ enum LineItemError.Reason
       1. + value PLACEHOLDER_COUNT_NOT_SUPPORTED
    4. ≠ enum UnitType
       1. + value COMPLETED_VIEWS
20. = InventoryService (無變更)
21. = LabelService (無變更)
22. ≠ LineItemCreativeAssociationService (0 new, 1 changed, 0 removed)
    1. ≠ enum LineItemError.Reason
       1. + value PLACEHOLDER_COUNT_NOT_SUPPORTED
23. ≠ LineItemService (0 new, 4 changed, 0 removed)
    1. ≠ enum CostType
       1. + 價值 CPCV
    2. ≠ enum DateTimeRangeTargetingError.Reason
       1. + 值 BLACKOUT_DURATION_TOO_SHORT
    3. ≠ enum LineItemError.Reason
       1. + value PLACEHOLDER_COUNT_NOT_SUPPORTED
    4. ≠ enum UnitType
       1. + value COMPLETED_VIEWS
24. ≠ LineItemTemplateService (0 new, 2 changed, 0 removed)
    1. ≠ enum DateTimeRangeTargetingError.Reason
       1. + 值 BLACKOUT_DURATION_TOO_SHORT
    2. ≠ enum LineItemError.Reason
       1. + value PLACEHOLDER_COUNT_NOT_SUPPORTED
25. ≠ LiveStreamEventService (0 new, 1 changed, 0 removed)
    1. ≠ enum VideoAdTagError.Reason
       1. + value DUPLICATE_AD_TAG_PARAMETER
26. = MobileApplicationService (無變更)
27. ≠ NativeStyleService (0 new, 1 changed, 0 removed)
    1. ≠ enum NativeStyleError.Reason
       1. + value INVALID_FLUID_SIZE_FOR_NEWSLETTER_FORMAT
28. = NetworkService (不變)
29. ≠ OrderService (0 new, 2 changed, 0 removed)
    1. ≠ enum DateTimeRangeTargetingError.Reason
       1. + 值 BLACKOUT_DURATION_TOO_SHORT
    2. ≠ enum LineItemError.Reason
       1. + value PLACEHOLDER_COUNT_NOT_SUPPORTED
30. = PlacementService (無變更)
31. ≠ ProposalLineItemService (0 new, 3 changed, 0 removed)
    1. ≠ enum DateTimeRangeTargetingError.Reason
       1. + 值 BLACKOUT_DURATION_TOO_SHORT
    2. ≠ enum LineItemError.Reason
       1. + value PLACEHOLDER_COUNT_NOT_SUPPORTED
    3. ≠ enum UnitType
       1. + value COMPLETED_VIEWS
32. = ProposalService (無變更)
33. = PublisherQueryLanguageService (無變更)
34. = ReportService (無變更)
35. = SegmentPopulationService (無變更)
36. = SiteService (無變更)
37. ≠ StreamActivityMonitorService (0 new, 1 changed, 0 removed)
    1. ≠ type VodStreamCreateRequest
       1. + 欄位 podServingSessionTitle
38. = SuggestedAdUnitService (沒有變更)
39. ≠ TargetingPresetService (0 new, 1 changed, 0 removed)
    1. ≠ enum DateTimeRangeTargetingError.Reason
       1. + 值 BLACKOUT_DURATION_TOO_SHORT
40. = TeamService (不變)
41. = UserService (無變更)
42. = UserTeamAssociationService (no changes)
43. ≠ YieldGroupService (0 new, 1 changed, 0 removed)
    1. ≠ enum DateTimeRangeTargetingError.Reason
       1. + 值 BLACKOUT_DURATION_TOO_SHORT

v202505

新功能

多重客戶管理

• 為公司新增 InvitationStatus ChildPublisher。

委刊項

• 在 LineItems 中新增 repeatedCreativeServingEnabled 欄位。

提案委刊項

• 新增 BuyerPermissionType 至 ProposalLineItems ，控管買方在交易中進行交易的方式。

API 變更

1. = AdRuleService (無變更)
2. ≠ AdjustmentService (0 new, 1 changed, 0 removed)
   1. ≠ enum ForecastAdjustmentError.Reason
      1. + value AD_REQUEST_ADJUSTMENT_MUST_USE_PARENT_SEGMENT_TARGETING
3. = AdsTxtService (無變更)
4. = AudienceSegmentService (no changes)
5. = CdnConfigurationService (無變更)
6. = CmsMetadataService (無變更)
7. ≠ CompanyService (1 new, 2 changed, 0 removed)
   1. + enum InvitationStatus
   2. ≠ type ChildPublisher
      1. + field invitationStatus
      2. − 欄位狀態
   3. ≠ enum McmError.Reason
      1. + value OPERATION_UNSUPPORTED_INITIAL_STATUS
8. = ContactService (no changes)
9. = ContentBundleService (無變更)
10. ≠ ContentService (0 new, 1 changed, 0 removed)
    1. ≠ enum VodIngestError
       1. + value DISCONTINUITY_COUNT_DOES_NOT_MATCH_PTS_COUNT
11. ≠ CreativeService (0 new, 1 changed, 0 removed)
    1. ≠ enum CreativeError.Reason
       1. − 值 INVALID_ADSENSE_CREATIVE_SIZE
       2. − value INVALID_AD_EXCHANGE_CREATIVE_SIZE
12. ≠ CreativeSetService (0 new, 1 changed, 0 removed)
    1. ≠ enum CreativeError.Reason
       1. − 值 INVALID_ADSENSE_CREATIVE_SIZE
       2. − value INVALID_AD_EXCHANGE_CREATIVE_SIZE
13. = CreativeTemplateService (無變更)
14. = CreativeWrapperService (no changes)
15. = CustomFieldService (無變更)
16. = CustomTargetingService (no changes)
17. = DaiAuthenticationKeyService (no changes)
18. = DaiEncodingProfileService (無變更)
19. ≠ ForecastService (0 new, 6 changed, 0 removed)
    1. ≠ enum CreativeError.Reason
       1. − 值 INVALID_ADSENSE_CREATIVE_SIZE
       2. − value INVALID_AD_EXCHANGE_CREATIVE_SIZE
    2. ≠ enum LineItemError.Reason
       1. + 值 REPEATED_CREATIVE_SERVING_NOT_ALLOWED
    3. ≠ type LineItemSummary
       1. + field repeatedCreativeServingEnabled
    4. ≠ enum ProgrammaticError.Reason
       1. + 值 INVALID_BUYER
    5. ≠ type ProposalLineItem
       1. + 欄位 buyerPermissionType
    6. ≠ enum TargetingDimension
       1. − 值 VIDEO_POSITION
20. = InventoryService (無變更)
21. = LabelService (無變更)
22. ≠ LineItemCreativeAssociationService (0 new, 2 changed, 0 removed)
    1. ≠ enum CreativeError.Reason
       1. − 值 INVALID_ADSENSE_CREATIVE_SIZE
       2. − value INVALID_AD_EXCHANGE_CREATIVE_SIZE
    2. ≠ enum LineItemError.Reason
       1. + 值 REPEATED_CREATIVE_SERVING_NOT_ALLOWED
23. ≠ LineItemService (0 new, 4 changed, 0 removed)
    1. ≠ enum CreativeError.Reason
       1. − 值 INVALID_ADSENSE_CREATIVE_SIZE
       2. − value INVALID_AD_EXCHANGE_CREATIVE_SIZE
    2. ≠ enum LineItemError.Reason
       1. + 值 REPEATED_CREATIVE_SERVING_NOT_ALLOWED
    3. ≠ type LineItemSummary
       1. + field repeatedCreativeServingEnabled
    4. ≠ enum ProgrammaticError.Reason
       1. + 值 INVALID_BUYER
24. ≠ LineItemTemplateService (0 new, 3 changed, 0 removed)
    1. ≠ enum CreativeError.Reason
       1. − 值 INVALID_ADSENSE_CREATIVE_SIZE
       2. − value INVALID_AD_EXCHANGE_CREATIVE_SIZE
    2. ≠ enum LineItemError.Reason
       1. + 值 REPEATED_CREATIVE_SERVING_NOT_ALLOWED
    3. ≠ enum ProgrammaticError.Reason
       1. + 值 INVALID_BUYER
25. = LiveStreamEventService (無變更)
26. = MobileApplicationService (無變更)
27. = NativeStyleService (不變)
28. ≠ NetworkService (0 new, 1 changed, 0 removed)
    1. ≠ enum McmError.Reason
       1. + value OPERATION_UNSUPPORTED_INITIAL_STATUS
29. ≠ OrderService (0 new, 3 changed, 0 removed)
    1. ≠ enum CreativeError.Reason
       1. − 值 INVALID_ADSENSE_CREATIVE_SIZE
       2. − value INVALID_AD_EXCHANGE_CREATIVE_SIZE
    2. ≠ enum LineItemError.Reason
       1. + 值 REPEATED_CREATIVE_SERVING_NOT_ALLOWED
    3. ≠ enum ProgrammaticError.Reason
       1. + 值 INVALID_BUYER
30. = PlacementService (無變更)
31. ≠ ProposalLineItemService (0 new, 3 changed, 0 removed)
    1. ≠ enum LineItemError.Reason
       1. + 值 REPEATED_CREATIVE_SERVING_NOT_ALLOWED
    2. ≠ enum ProgrammaticError.Reason
       1. + 值 INVALID_BUYER
    3. ≠ type ProposalLineItem
       1. + 欄位 buyerPermissionType
32. ≠ ProposalService (0 new, 1 changed, 0 removed)
    1. ≠ enum ProgrammaticError.Reason
       1. + 值 INVALID_BUYER
33. ≠ PublisherQueryLanguageService (0 new, 1 changed, 0 removed)
    1. ≠ enum CreativeError.Reason
       1. − 值 INVALID_ADSENSE_CREATIVE_SIZE
       2. − value INVALID_AD_EXCHANGE_CREATIVE_SIZE
34. = ReportService (無變更)
35. = SegmentPopulationService (無變更)
36. = SiteService (無變更)
37. = StreamActivityMonitorService (無變更)
38. = SuggestedAdUnitService (沒有變更)
39. = TargetingPresetService (無變更)
40. = TeamService (不變)
41. = UserService (無變更)
42. = UserTeamAssociationService (no changes)
43. = YieldGroupService (無變更)

v202502

新功能

預設指定目標

• 新增了適用於有效預設指定目標限制的錯誤代碼。

API 變更

1. = AdRuleService (無變更)
2. ≠ AdjustmentService (0 new, 1 changed, 0 removed)
   1. ≠ enum EntityLimitReachedError.Reason
      1. + value ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
3. = AdsTxtService (無變更)
4. ≠ AudienceSegmentService (0 個新項目、1 個已變更、0 個已移除)
   1. ≠ enum EntityLimitReachedError.Reason
      1. + value ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
5. = CdnConfigurationService (無變更)
6. = CmsMetadataService (無變更)
7. = CompanyService (沒有變更)
8. = ContactService (no changes)
9. = ContentBundleService (無變更)
10. = ContentService (無變更)
11. ≠ CreativeService (0 個新增、2 個變更、0 個移除)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + value ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
    2. ≠ enum LineItemCreativeAssociationError.Reason
       1. + value CREATIVE_SKIPPABILITY_MISMATCH_WITH_LINE_ITEM
12. ≠ CreativeSetService (0 new, 1 changed, 0 removed)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + value ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
13. = CreativeTemplateService (無變更)
14. = CreativeWrapperService (no changes)
15. ≠ CustomFieldService (0 new, 1 changed, 0 removed)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + value ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
16. ≠ CustomTargetingService (0 new, 1 changed, 0 removed)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + value ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
17. = DaiAuthenticationKeyService (no changes)
18. ≠ DaiEncodingProfileService (0 new, 1 changed, 0 removed)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + value ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
19. ≠ ForecastService (0 new, 3 changed, 0 removed)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + value ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
    2. ≠ enum LineItemCreativeAssociationError.Reason
       1. + value CREATIVE_SKIPPABILITY_MISMATCH_WITH_LINE_ITEM
    3. ≠ enum OrderActionError.Reason
       1. + value CANNOT_UPDATE_ORDER_OVER_LINE_ITEM_LIMIT
20. ≠ InventoryService (0 new, 1 changed, 0 removed)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + value ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
21. = LabelService (無變更)
22. ≠ LineItemCreativeAssociationService (0 new, 3 changed, 0 removed)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + value ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
    2. ≠ enum LineItemCreativeAssociationError.Reason
       1. + value CREATIVE_SKIPPABILITY_MISMATCH_WITH_LINE_ITEM
    3. ≠ type LineItemCreativeAssociationStats
       1. − 欄位 costInOrderCurrency
23. ≠ LineItemService (0 new, 3 changed, 0 removed)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + value ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
    2. ≠ enum LineItemCreativeAssociationError.Reason
       1. + value CREATIVE_SKIPPABILITY_MISMATCH_WITH_LINE_ITEM
    3. ≠ enum OrderActionError.Reason
       1. + value CANNOT_UPDATE_ORDER_OVER_LINE_ITEM_LIMIT
24. ≠ LineItemTemplateService (0 new, 3 changed, 0 removed)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + value ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
    2. ≠ enum LineItemCreativeAssociationError.Reason
       1. + value CREATIVE_SKIPPABILITY_MISMATCH_WITH_LINE_ITEM
    3. ≠ enum OrderActionError.Reason
       1. + value CANNOT_UPDATE_ORDER_OVER_LINE_ITEM_LIMIT
25. ≠ LiveStreamEventService (0 new, 1 changed, 0 removed)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + value ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
26. = MobileApplicationService (無變更)
27. = NativeStyleService (不變)
28. = NetworkService (不變)
29. ≠ OrderService (0 new, 3 changed, 0 removed)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + value ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
    2. ≠ enum LineItemCreativeAssociationError.Reason
       1. + value CREATIVE_SKIPPABILITY_MISMATCH_WITH_LINE_ITEM
    3. ≠ enum OrderActionError.Reason
       1. + value CANNOT_UPDATE_ORDER_OVER_LINE_ITEM_LIMIT
30. ≠ PlacementService (0 個新增、1 個變更、0 個移除)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + value ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
31. ≠ ProposalLineItemService (0 new, 1 changed, 0 removed)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + value ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
32. ≠ ProposalService (0 new, 1 changed, 0 removed)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + value ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
33. ≠ PublisherQueryLanguageService (0 new, 1 changed, 0 removed)
    1. ≠ enum OrderActionError.Reason
       1. + value CANNOT_UPDATE_ORDER_OVER_LINE_ITEM_LIMIT
34. = ReportService (無變更)
35. = SegmentPopulationService (無變更)
36. ≠ SiteService (0 new, 1 changed, 0 removed)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + value ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
37. = StreamActivityMonitorService (無變更)
38. ≠ SuggestedAdUnitService (0 new, 1 changed, 0 removed)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + value ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
39. ≠ TargetingPresetService (0 new, 1 changed, 0 removed)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + value ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
40. ≠ TeamService (0 new, 1 changed, 0 removed)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + value ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
41. ≠ UserService (0 new, 1 changed, 0 removed)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + value ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
42. = UserTeamAssociationService (no changes)
43. ≠ YieldGroupService (0 new, 1 changed, 0 removed)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + value ACTIVE_TARGETING_PRESETS_LIMIT_REACHED

v202411

新功能

委刊項

• 已移除「GOOGLE」的 GrpProvider

報表

• 新增 INVENTORY_FORMAT 維度。

發布商查詢語言

• 已將表格欄位 Line_Item 重新命名為 endDateTime。servingEndTime在 202411 版和更早版本中，這個值包含任何寬限期。新名稱可區分 PQL 欄位與LineItem.endDateTime欄位，後者不含任何寬限期。

API 變更

1. = AdRuleService (無變更)
2. = AdjustmentService (no changes)
3. = AdsTxtService (無變更)
4. = AudienceSegmentService (no changes)
5. = CdnConfigurationService (無變更)
6. = CmsMetadataService (無變更)
7. = CompanyService (沒有變更)
8. = ContactService (no changes)
9. = ContentBundleService (無變更)
10. = ContentService (無變更)
11. = CreativeService (無變更)
12. = CreativeSetService (無變更)
13. = CreativeTemplateService (無變更)
14. = CreativeWrapperService (no changes)
15. = CustomFieldService (無變更)
16. = CustomTargetingService (no changes)
17. = DaiAuthenticationKeyService (no changes)
18. = DaiEncodingProfileService (無變更)
19. ≠ ForecastService (0 new, 1 changed, 0 removed)
    1. ≠ enum GrpProvider
       1. − 值 GOOGLE
20. = InventoryService (無變更)
21. = LabelService (無變更)
22. ≠ LineItemCreativeAssociationService (0 new, 2 changed, 1 removed)
    1. ≠ enum LineItemCreativeAssociation.Status
       1. − value NOT_SERVING
    2. ≠ operation pushCreativeToDevices
       1. − parameter filterStatement
       2. − 參數選項
       3. − 回應值
    3. − operation pushCreativeToDevices
23. ≠ LineItemService (0 new, 1 changed, 0 removed)
    1. ≠ enum GrpProvider
       1. − 值 GOOGLE
24. = LineItemTemplateService (不變)
25. = LiveStreamEventService (無變更)
26. = MobileApplicationService (無變更)
27. = NativeStyleService (不變)
28. = NetworkService (不變)
29. = OrderService (no changes)
30. = PlacementService (無變更)
31. ≠ ProposalLineItemService (0 new, 1 changed, 0 removed)
    1. ≠ enum GrpProvider
       1. − 值 GOOGLE
32. = ProposalService (無變更)
33. = PublisherQueryLanguageService (無變更)
34. ≠ ReportService (0 new, 1 changed, 0 removed)
    1. ≠ enum Dimension
       1. + 值 INVENTORY_FORMAT
       2. + 值 INVENTORY_FORMAT_NAME
35. = SegmentPopulationService (無變更)
36. ≠ SiteService (0 new, 1 changed, 0 removed)
    1. ≠ type Site
       1. − 個有效欄位
37. = StreamActivityMonitorService (無變更)
38. = SuggestedAdUnitService (沒有變更)
39. = TargetingPresetService (無變更)
40. = TeamService (不變)
41. = UserService (無變更)
42. = UserTeamAssociationService (no changes)
43. = YieldGroupService (無變更)