Примечания к выпуску

На этой странице представлены примечания к выпуску текущих версий API Google Ad Manager. Примечания к выпуску некоторых предыдущих версий, которые больше не доступны, представлены исключительно для полноты информации.

• Последняя версия: v202508
• Предыдущие версии: v202505 , v202502 , v202411

v202508

Что нового

Видео

• Добавлен MimeType.VIDEO_MP2T .

Позиции

• Добавлен CostType.CPCV .
• Добавлен UnitType.COMPLETED_VIEWS .

Изменения API

1. = AdRuleService (без изменений)
2. ≠ AdjustmentService (0 новых, 2 измененных, 0 удаленных)
   1. ≠ enum DateTimeRangeTargetingError.Reason
      1. + значение BLACKOUT_DURATION_TOO_SHORT
   2. ≠ enum ForecastAdjustmentError.Reason
      1. − значение PARENT_SEGMENT_TARGETING_INCOMPATIBLE_WITH_HISTORICAL_BASIS_AD_REQUEST_SOURCE_SETTINGS
3. = AdsTxtService (без изменений)
4. = AudienceSegmentService (без изменений)
5. = CdnConfigurationService (без изменений)
6. = CmsMetadataService (без изменений)
7. = CompanyService (без изменений)
8. = ContactService (без изменений)
9. = ContentBundleService (без изменений)
10. ≠ ContentService (0 новых, 2 измененных, 0 удаленных)
    1. ≠ enum MimeType
       1. + значение VIDEO_MP2T
    2. ≠ enum VodIngestError
       1. + значение CHAPTER_PTS_MISMATCH
       2. + значение CHAPTER_RENDITION_ERROR
11. ≠ CreativeService (0 новых, 2 измененных, 0 удаленных)
    1. ≠ тип Креатив
       1. + поле selfDeclaredEuropeanUnionPoliticalContent
    2. ≠ enum MimeType
       1. + значение VIDEO_MP2T
12. = CreativeSetService (без изменений)
13. = CreativeTemplateService (без изменений)
14. = CreativeWrapperService (без изменений)
15. = CustomFieldService (без изменений)
16. = CustomTargetingService (без изменений)
17. = DaiAuthenticationKeyService (без изменений)
18. = DaiEncodingProfileService (без изменений)
19. ≠ ForecastService (0 новых, 4 измененных, 0 удаленных)
    1. ≠ enum CostType
       1. + значение CPCV
    2. ≠ enum DateTimeRangeTargetingError.Reason
       1. + значение BLACKOUT_DURATION_TOO_SHORT
    3. ≠ enum LineItemError.Reason
       1. + значение PLACEHOLDER_COUNT_NOT_SUPPORTED
    4. ≠ enum UnitType
       1. + значение COMPLETED_VIEWS
20. = InventoryService (без изменений)
21. = LabelService (без изменений)
22. ≠ LineItemCreativeAssociationService (0 новых, 1 изменено, 0 удалено)
    1. ≠ enum LineItemError.Reason
       1. + значение PLACEHOLDER_COUNT_NOT_SUPPORTED
23. ≠ LineItemService (0 новых, 4 измененных, 0 удаленных)
    1. ≠ enum CostType
       1. + значение CPCV
    2. ≠ enum DateTimeRangeTargetingError.Reason
       1. + значение BLACKOUT_DURATION_TOO_SHORT
    3. ≠ enum LineItemError.Reason
       1. + значение PLACEHOLDER_COUNT_NOT_SUPPORTED
    4. ≠ enum UnitType
       1. + значение COMPLETED_VIEWS
24. ≠ LineItemTemplateService (0 новых, 2 измененных, 0 удаленных)
    1. ≠ enum DateTimeRangeTargetingError.Reason
       1. + значение BLACKOUT_DURATION_TOO_SHORT
    2. ≠ enum LineItemError.Reason
       1. + значение PLACEHOLDER_COUNT_NOT_SUPPORTED
25. ≠ LiveStreamEventService (0 новых, 1 изменено, 0 удалено)
    1. ≠ enum VideoAdTagError.Reason
       1. + значение DUPLICATE_AD_TAG_PARAMETER
26. = MobileApplicationService (без изменений)
27. ≠ NativeStyleService (0 новых, 1 изменено, 0 удалено)
    1. ≠ enum NativeStyleError.Reason
       1. + значение НЕВЕРНЫЙ_РАЗМЕР_ФЛЮИДА_ДЛЯ_ФОРМАТА_НОВОСТИ
28. = NetworkService (без изменений)
29. ≠ OrderService (0 новых, 2 измененных, 0 удаленных)
    1. ≠ enum DateTimeRangeTargetingError.Reason
       1. + значение BLACKOUT_DURATION_TOO_SHORT
    2. ≠ enum LineItemError.Reason
       1. + значение PLACEHOLDER_COUNT_NOT_SUPPORTED
30. = PlacementService (без изменений)
31. ≠ ProposalLineItemService (0 новых, 3 измененных, 0 удаленных)
    1. ≠ enum DateTimeRangeTargetingError.Reason
       1. + значение BLACKOUT_DURATION_TOO_SHORT
    2. ≠ enum LineItemError.Reason
       1. + значение PLACEHOLDER_COUNT_NOT_SUPPORTED
    3. ≠ enum UnitType
       1. + значение COMPLETED_VIEWS
32. = ProposalService (без изменений)
33. = PublisherQueryLanguageService (без изменений)
34. = ReportService (без изменений)
35. = SegmentPopulationService (без изменений)
36. = SiteService (без изменений)
37. ≠ StreamActivityMonitorService (0 новых, 1 изменено, 0 удалено)
    1. ≠ тип VodStreamCreateRequest
       1. + поле podServingSessionTitle
38. = SuggestedAdUnitService (без изменений)
39. ≠ TargetingPresetService (0 новых, 1 изменено, 0 удалено)
    1. ≠ enum DateTimeRangeTargetingError.Reason
       1. + значение BLACKOUT_DURATION_TOO_SHORT
40. = TeamService (без изменений)
41. = UserService (без изменений)
42. = UserTeamAssociationService (без изменений)
43. ≠ YieldGroupService (0 новых, 1 изменено, 0 удалено)
    1. ≠ enum DateTimeRangeTargetingError.Reason
       1. + значение BLACKOUT_DURATION_TOO_SHORT

v202505

Что нового

Управление несколькими клиентами

• Добавлен InvitationStatus для компаний ChildPublisher .

Позиции

• Добавлено поле repeatedCreativeServingEnabled в LineItems .

Позиции предложения

• Добавлен BuyerPermissionType в ProposalLineItems для управления тем, как покупатели могут совершать сделки.

Изменения API

1. = AdRuleService (без изменений)
2. ≠ AdjustmentService (0 новых, 1 изменено, 0 удалено)
   1. ≠ enum ForecastAdjustmentError.Reason
      1. + значение AD_REQUEST_ADJUSTMENT_MUST_USE_PARENT_SEGMENT_TARGETING
3. = AdsTxtService (без изменений)
4. = AudienceSegmentService (без изменений)
5. = CdnConfigurationService (без изменений)
6. = CmsMetadataService (без изменений)
7. ≠ CompanyService (1 новый, 2 изменено, 0 удалено)
   1. + enum InvitationStatus
   2. ≠ тип ChildPublisher
      1. + поле приглашениеСтатус
      2. − статус поля
   3. ≠ enum McmError.Reason
      1. + значение OPERATION_UNSUPPORTED_INITIAL_STATUS
8. = ContactService (без изменений)
9. = ContentBundleService (без изменений)
10. ≠ ContentService (0 новых, 1 изменено, 0 удалено)
    1. ≠ enum VodIngestError
       1. + значение DISCONTINUITY_COUNT_DOES_NOT_MATCH_PTS_COUNT
11. ≠ CreativeService (0 новых, 1 изменено, 0 удалено)
    1. ≠ enum CreativeError.Reason
       1. − значение INVALID_ADSENSE_CREATIVE_SIZE
       2. − значение INVALID_AD_EXCHANGE_CREATIVE_SIZE
12. ≠ CreativeSetService (0 новых, 1 изменено, 0 удалено)
    1. ≠ enum CreativeError.Reason
       1. − значение INVALID_ADSENSE_CREATIVE_SIZE
       2. − значение INVALID_AD_EXCHANGE_CREATIVE_SIZE
13. = CreativeTemplateService (без изменений)
14. = CreativeWrapperService (без изменений)
15. = CustomFieldService (без изменений)
16. = CustomTargetingService (без изменений)
17. = DaiAuthenticationKeyService (без изменений)
18. = DaiEncodingProfileService (без изменений)
19. ≠ ForecastService (0 новых, 6 измененных, 0 удаленных)
    1. ≠ enum CreativeError.Reason
       1. − значение INVALID_ADSENSE_CREATIVE_SIZE
       2. − значение INVALID_AD_EXCHANGE_CREATIVE_SIZE
    2. ≠ enum LineItemError.Reason
       1. + значение REPEATED_CREATIVE_SERVING_NOT_ALLOWED
    3. ≠ тип LineItemSummary
       1. + поле repeatedCreativeServingEnabled
    4. ≠ enum ProgrammaticError.Reason
       1. + значение INVALID_BUYER
    5. ≠ тип ProposalLineItem
       1. + поле buyerPermissionType
    6. ≠ enum TargetingDimension
       1. − значение VIDEO_POSITION
20. = InventoryService (без изменений)
21. = LabelService (без изменений)
22. ≠ LineItemCreativeAssociationService (0 новых, 2 измененных, 0 удаленных)
    1. ≠ enum CreativeError.Reason
       1. − значение INVALID_ADSENSE_CREATIVE_SIZE
       2. − значение INVALID_AD_EXCHANGE_CREATIVE_SIZE
    2. ≠ enum LineItemError.Reason
       1. + значение REPEATED_CREATIVE_SERVING_NOT_ALLOWED
23. ≠ LineItemService (0 новых, 4 измененных, 0 удаленных)
    1. ≠ enum CreativeError.Reason
       1. − значение INVALID_ADSENSE_CREATIVE_SIZE
       2. − значение INVALID_AD_EXCHANGE_CREATIVE_SIZE
    2. ≠ enum LineItemError.Reason
       1. + значение REPEATED_CREATIVE_SERVING_NOT_ALLOWED
    3. ≠ тип LineItemSummary
       1. + поле repeatedCreativeServingEnabled
    4. ≠ enum ProgrammaticError.Reason
       1. + значение INVALID_BUYER
24. ≠ LineItemTemplateService (0 новых, 3 измененных, 0 удаленных)
    1. ≠ enum CreativeError.Reason
       1. − значение INVALID_ADSENSE_CREATIVE_SIZE
       2. − значение 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 новых, 1 изменено, 0 удалено)
    1. ≠ enum McmError.Reason
       1. + значение OPERATION_UNSUPPORTED_INITIAL_STATUS
29. ≠ OrderService (0 новых, 3 измененных, 0 удаленных)
    1. ≠ enum CreativeError.Reason
       1. − значение INVALID_ADSENSE_CREATIVE_SIZE
       2. − значение 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 новых, 3 измененных, 0 удаленных)
    1. ≠ enum LineItemError.Reason
       1. + значение REPEATED_CREATIVE_SERVING_NOT_ALLOWED
    2. ≠ enum ProgrammaticError.Reason
       1. + значение INVALID_BUYER
    3. ≠ тип ProposalLineItem
       1. + поле buyerPermissionType
32. ≠ ProposalService (0 новых, 1 изменено, 0 удалено)
    1. ≠ enum ProgrammaticError.Reason
       1. + значение INVALID_BUYER
33. ≠ PublisherQueryLanguageService (0 новых, 1 изменено, 0 удалено)
    1. ≠ enum CreativeError.Reason
       1. − значение INVALID_ADSENSE_CREATIVE_SIZE
       2. − значение INVALID_AD_EXCHANGE_CREATIVE_SIZE
34. = ReportService (без изменений)
35. = SegmentPopulationService (без изменений)
36. = SiteService (без изменений)
37. = StreamActivityMonitorService (без изменений)
38. = SuggestedAdUnitService (без изменений)
39. = TargetingPresetService (без изменений)
40. = TeamService (без изменений)
41. = UserService (без изменений)
42. = UserTeamAssociationService (без изменений)
43. = YieldGroupService (без изменений)

v202502

Что нового

Предустановки таргетинга

• Добавлен новый код ошибки для предустановленных пределов активного нацеливания.

Изменения API

1. = AdRuleService (без изменений)
2. ≠ AdjustmentService (0 новых, 1 изменено, 0 удалено)
   1. ≠ enum EntityLimitReachedError.Reason
      1. + значение ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
3. = AdsTxtService (без изменений)
4. ≠ AudienceSegmentService (0 новых, 1 изменено, 0 удалено)
   1. ≠ enum EntityLimitReachedError.Reason
      1. + значение ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
5. = CdnConfigurationService (без изменений)
6. = CmsMetadataService (без изменений)
7. = CompanyService (без изменений)
8. = ContactService (без изменений)
9. = ContentBundleService (без изменений)
10. = ContentService (без изменений)
11. ≠ CreativeService (0 новых, 2 измененных, 0 удаленных)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + значение ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
    2. ≠ enum LineItemCreativeAssociationError.Reason
       1. + значение CREATIVE_SKIPPABILITY_MISMATCH_WITH_LINE_ITEM
12. ≠ CreativeSetService (0 новых, 1 изменено, 0 удалено)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + значение ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
13. = CreativeTemplateService (без изменений)
14. = CreativeWrapperService (без изменений)
15. ≠ CustomFieldService (0 новых, 1 изменено, 0 удалено)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + значение ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
16. ≠ CustomTargetingService (0 новых, 1 изменено, 0 удалено)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + значение ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
17. = DaiAuthenticationKeyService (без изменений)
18. ≠ DaiEncodingProfileService (0 новых, 1 изменено, 0 удалено)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + значение ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
19. ≠ ForecastService (0 новых, 3 измененных, 0 удаленных)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + значение ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
    2. ≠ enum LineItemCreativeAssociationError.Reason
       1. + значение CREATIVE_SKIPPABILITY_MISMATCH_WITH_LINE_ITEM
    3. ≠ enum OrderActionError.Reason
       1. + значение CANNOT_UPDATE_ORDER_OVER_LINE_ITEM_LIMIT
20. ≠ InventoryService (0 новых, 1 изменено, 0 удалено)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + значение ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
21. = LabelService (без изменений)
22. ≠ LineItemCreativeAssociationService (0 новых, 3 измененных, 0 удаленных)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + значение ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
    2. ≠ enum LineItemCreativeAssociationError.Reason
       1. + значение CREATIVE_SKIPPABILITY_MISMATCH_WITH_LINE_ITEM
    3. ≠ тип LineItemCreativeAssociationStats
       1. − поле costInOrderCurrency
23. ≠ LineItemService (0 новых, 3 измененных, 0 удаленных)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + значение ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
    2. ≠ enum LineItemCreativeAssociationError.Reason
       1. + значение CREATIVE_SKIPPABILITY_MISMATCH_WITH_LINE_ITEM
    3. ≠ enum OrderActionError.Reason
       1. + значение CANNOT_UPDATE_ORDER_OVER_LINE_ITEM_LIMIT
24. ≠ LineItemTemplateService (0 новых, 3 измененных, 0 удаленных)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + значение ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
    2. ≠ enum LineItemCreativeAssociationError.Reason
       1. + значение CREATIVE_SKIPPABILITY_MISMATCH_WITH_LINE_ITEM
    3. ≠ enum OrderActionError.Reason
       1. + значение CANNOT_UPDATE_ORDER_OVER_LINE_ITEM_LIMIT
25. ≠ LiveStreamEventService (0 новых, 1 изменено, 0 удалено)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + значение ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
26. = MobileApplicationService (без изменений)
27. = NativeStyleService (без изменений)
28. = NetworkService (без изменений)
29. ≠ OrderService (0 новых, 3 измененных, 0 удаленных)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + значение ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
    2. ≠ enum LineItemCreativeAssociationError.Reason
       1. + значение CREATIVE_SKIPPABILITY_MISMATCH_WITH_LINE_ITEM
    3. ≠ enum OrderActionError.Reason
       1. + значение CANNOT_UPDATE_ORDER_OVER_LINE_ITEM_LIMIT
30. ≠ PlacementService (0 новых, 1 изменено, 0 удалено)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + значение ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
31. ≠ ProposalLineItemService (0 новых, 1 изменено, 0 удалено)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + значение ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
32. ≠ ProposalService (0 новых, 1 изменено, 0 удалено)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + значение ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
33. ≠ PublisherQueryLanguageService (0 новых, 1 изменено, 0 удалено)
    1. ≠ enum OrderActionError.Reason
       1. + значение CANNOT_UPDATE_ORDER_OVER_LINE_ITEM_LIMIT
34. = ReportService (без изменений)
35. = SegmentPopulationService (без изменений)
36. ≠ SiteService (0 новых, 1 изменено, 0 удалено)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + значение ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
37. = StreamActivityMonitorService (без изменений)
38. ≠ SuggestedAdUnitService (0 новых, 1 изменено, 0 удалено)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + значение ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
39. ≠ TargetingPresetService (0 новых, 1 изменено, 0 удалено)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + значение ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
40. ≠ TeamService (0 новых, 1 изменено, 0 удалено)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + значение ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
41. ≠ UserService (0 новых, 1 изменено, 0 удалено)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + значение ACTIVE_TARGETING_PRESETS_LIMIT_REACHED
42. = UserTeamAssociationService (без изменений)
43. ≠ YieldGroupService (0 новых, 1 изменено, 0 удалено)
    1. ≠ enum EntityLimitReachedError.Reason
       1. + значение ACTIVE_TARGETING_PRESETS_LIMIT_REACHED

v202411

Что нового

Позиции

• Удален GOOGLE как GrpProvider

Отчетность

• Добавлены измерения INVENTORY_FORMAT .

Язык запросов издателя

• Поле таблицы Line_Item endDateTime переименовано в servingEndTime . В версии v202411 и более ранних версиях значение включает любой льготный период . Новое название отличает поле PQL от поля LineItem.endDateTime , которое не включает любой льготный период.

Изменения API

1. = AdRuleService (без изменений)
2. = AdjustmentService (без изменений)
3. = AdsTxtService (без изменений)
4. = AudienceSegmentService (без изменений)
5. = CdnConfigurationService (без изменений)
6. = CmsMetadataService (без изменений)
7. = CompanyService (без изменений)
8. = ContactService (без изменений)
9. = ContentBundleService (без изменений)
10. = ContentService (без изменений)
11. = CreativeService (без изменений)
12. = CreativeSetService (без изменений)
13. = CreativeTemplateService (без изменений)
14. = CreativeWrapperService (без изменений)
15. = CustomFieldService (без изменений)
16. = CustomTargetingService (без изменений)
17. = DaiAuthenticationKeyService (без изменений)
18. = DaiEncodingProfileService (без изменений)
19. ≠ ForecastService (0 новых, 1 изменено, 0 удалено)
    1. ≠ enum GrpProvider
       1. − значение GOOGLE
20. = InventoryService (без изменений)
21. = LabelService (без изменений)
22. ≠ LineItemCreativeAssociationService (0 новых, 2 измененных, 1 удаленных)
    1. ≠ enum LineItemCreativeAssociation.Status
       1. − значение NOT_SERVING
    2. ≠ операция pushCreativeToDevices
       1. − параметр filterStatement
       2. − параметры параметров
       3. − ответ rval
    3. − операция pushCreativeToDevices
23. ≠ LineItemService (0 новых, 1 изменено, 0 удалено)
    1. ≠ enum GrpProvider
       1. − значение GOOGLE
24. = LineItemTemplateService (без изменений)
25. = LiveStreamEventService (без изменений)
26. = MobileApplicationService (без изменений)
27. = NativeStyleService (без изменений)
28. = NetworkService (без изменений)
29. = OrderService (без изменений)
30. = PlacementService (без изменений)
31. ≠ ProposalLineItemService (0 новых, 1 изменено, 0 удалено)
    1. ≠ enum GrpProvider
       1. − значение GOOGLE
32. = ProposalService (без изменений)
33. = PublisherQueryLanguageService (без изменений)
34. ≠ ReportService (0 новых, 1 изменено, 0 удалено)
    1. ≠ enum Dimension
       1. + значение INVENTORY_FORMAT
       2. + значение ИНВЕНТАРНЫЙ_ФОРМАТ_НАЗВАНИЕ
35. = SegmentPopulationService (без изменений)
36. ≠ SiteService (0 новых, 1 изменено, 0 удалено)
    1. ≠ тип Сайт
       1. − поле активное
37. = StreamActivityMonitorService (без изменений)
38. = SuggestedAdUnitService (без изменений)
39. = TargetingPresetService (без изменений)
40. = TeamService (без изменений)
41. = UserService (без изменений)
42. = UserTeamAssociationService (без изменений)
43. = YieldGroupService (без изменений)