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

v19 (26 февраля 2025 г.)

Следующие функции и изменения были добавлены в v19.

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

  • В CustomerError добавлены следующие значения для учета предстоящих изменений:
    • CREATION_DENIED_FOR_POLICY_VIOLATION
    • CREATION_DENIED_INELIGIBLE_MCC

Объявления

Ресурсы

Конверсии

  • Цели конверсии
  • Устаревший ConversionActionType.SALESFORCE .

Ленты

  • Удалены все объекты, связанные с фидом, такие как Feed , FeedMapping , FeedService , AdGroupFeed , feed_placeholder_view и т. д. Теперь пользователи должны использовать ресурсы для достижения той же цели. Посетите «Заметки о миграции» , чтобы просмотреть список всех удаленных объектов.

Отель и путешествия

  • Сделано min_days и max_days для ValueRuleItineraryAdvanceBookingWindow optional полем, позволяющим указывать 0 в качестве значения. Это поддерживает таргетинг на поисковые запросы о путешествиях, которые происходят сегодня.

Максимальная эффективность

  • (Только для аккаунтов из белого списка) Рекомендации по использованию бренда
    • Campaign.brand_guidelines_enabled изменен только при создании кампании с максимальной эффективностью.
    • Это несовместимо с максимальной эффективностью для целей путешествий .
    • Чтобы включить рекомендации по брендингу для существующих кампаний с максимальной эффективностью, используйте недавно добавленный CampaignService.EnablePMaxBrandGuidelines . Отключение рекомендаций по бренду не поддерживается.
    • Добавлены Campaign.brand_guidelines и BrandGuidelines , позволяющие задавать цвета бренда и семейство шрифтов.
    • Новые значения ошибок:
    • CampaignError
      • BRAND_GUIDELINES_NOT_ENABLED_FOR_CAMPAIGN
      • BRAND_GUIDELINES_MAIN_AND_ACCENT_COLORS_REQUIRED
      • BRAND_GUIDELINES_COLOR_INVALID_FORMAT
      • BRAND_GUIDELINES_UNSUPPORTED_FONT_FAMILY
      • BRAND_GUIDELINES_UNSUPPORTED_CHANNEL
      • CANNOT_ENABLE_BRAND_GUIDELINES_FOR_TRAVEL_GOALS
      • CUSTOMER_NOT_ALLOWLISTED_FOR_BRAND_GUIDELINES
  • Добавлен AssetAutomationType.GENERATE_ENHANCED_YOUTUBE_VIDEOS для поддержки автоматического создания расширенных видеоресурсов для кампаний с максимальной эффективностью.

Планирование

  • (Только для учетных записей, внесенных в белый список) Добавлен ContentCreatorInsightsService.GenerateTrendingInsights , который позволяет пользователям видеть популярные темы контента на YouTube для заданных определений аудитории.
  • Добавлен GenerateCreatorInsightsRequest.country_locations[] для указания стран для поиска по заданным критериям.
  • Добавлен GenerateCreatorInsightsRequest.search_brand для указания бренда для поиска авторов.
  • В YouTubeChannelInsights добавлены новые поля для предоставления дополнительной информации о канале для запросов search_channels :
    • channel_url
    • channel_description
    • top_videos
  • В AudienceInsightsAttributeMetadata добавлены новые поля метаданных:
    • youtube_video_metadata
    • user_interest_attribute_metadata
    • knowledge_graph_attribute_metadata

Видео

  • После выпуска DataLinkService.CreateDataLink мы добавили следующие методы, позволяющие изменять ранее созданные связи данных:
    • RemoveDataLink для удаления ссылок на данные в аккаунте Google Рекламы.
    • UpdateDataLink для принятия, отклонения и отзыва ссылок на данные в аккаунте Google Рекламы.
  • Удалена поддержка VIDEO_OUTSTREAM из следующих перечислений:

v18 (16 октября 2024 г.)

Следующие новые функции и обновления были добавлены в v18.

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

  • (Только для аккаунтов из белого списка) Добавлен DataLinkService.CreateDataLink , который позволяет связать аккаунт Google Рекламы с видео автора, размещенными на его канале YouTube. Связь с видео позволяет аккаунту Google Рекламы показывать партнерскую рекламу с использованием видеороликов авторов.

Группы объявлений

  • Добавлен AdGroup.exclude_demographic_expansion , который позволяет исключить расширение демографических данных, если optimized_targeting_enabled установлено значение true . Эта функция ранее поддерживалась только для формирования спроса.

Объявления

  • Добавлен AdGroupAd.ad_group_ad_asset_automation_settings , который позволяет включать или отключать автоматическое создание ресурсов для объявлений.
  • В AssetAutomationType добавлены следующие значения:
    • GENERATE_VERTICAL_YOUTUBE_VIDEOS
    • GENERATE_SHORTER_YOUTUBE_VIDEOS
  • Добавлен AdNetworkType.GOOGLE_OWNED_CHANNELS , который используется объявлениями, показываемыми на каналах, принадлежащих Google, таких как YouTube, Gmail и канал Discover.

Ресурсы

Кампании

Критерий

  • Добавлен content_criterion_view , который возвращает показатели эффективности целевого контента , такие как ключевые слова, места размещения и темы, для кампаний в контекстно-медийной сети, формирования спроса и видеокампаний.

Отель и путешествия

Местные услуги

  • PhoneCallDetails.call_recording_url будет пустым вместо предоставления недопустимого URL-адреса, если запись звонка не существует для данного разговора с ведущим местными службами.
  • Добавлен CategoryBid.target_cpa_bid_micro , который позволяет устанавливать целевую цену за конверсию для категории через Campaign.local_services_campaign_settings .

Максимальная эффективность

  • Поддержка рекомендаций бренда
    • Добавлен Campaign.brand_guidelines_enabled , который показывает, включены ли рекомендации бренда для данной кампании с максимальной эффективностью. Если этот параметр включен, активы с field_type , установленным на BUSINESS_NAME , LOGO , LANDSCAPE_LOGO должны быть связаны как ресурсы CampaignAsset , а не как ресурсы AssetGroupAsset .
    • Добавлены ошибки CampaignError.REQUIRED_BUSINESS_NAME_ASSET_NOT_LINKED и CampaignError.REQUIRED_LOGO_ASSET_NOT_LINKED , которые указывают на то, что в кампаниях с максимальной эффективностью с включенными рекомендациями по бренду нет необходимых ресурсов CampaignAsset , связанных с кампанией.
    • Если правила бренда включены, по крайней мере один объект с field_type установленным на BUSINESS_NAME , и хотя бы один с LOGO должен быть связан с кампанией в качестве ресурсов CampaignAsset . Кампании с максимальной эффективностью для онлайн-продаж с фидом товаров должны соответствовать этому требованию только при наличии объектов, связанных с группами объектов кампании.
    • В AssetLinkError добавлены следующие значения:
      • BRAND_ASSETS_NOT_LINKED_AT_ASSET_GROUP_LEVEL , который выдается при попытке связать активы бренда с кампаниями в качестве ресурсов CampaignAsset вместо ресурсов AssetGroupAsset в кампаниях с максимальной эффективностью, в которых не включены рекомендации по бренду .
      • Ошибка BRAND_ASSETS_NOT_LINKED_AT_CAMPAIGN_LEVEL , которая возникает при попытке связать ресурсы бренда с кампаниями как ресурсы AssetGroupAsset вместо ресурсов CampaignAsset в кампаниях с максимальной эффективностью с включенными рекомендациями по бренду.
  • Добавлен performance_max_placement_view , который возвращает показы мест размещения, где показывались объявления с максимальной эффективностью.
  • Добавлен AssetGroupListingGroupFilterError.TREE_WAS_INVALID_BEFORE_MUTATION

Планирование

  • (Только для учетных записей, внесенных в белый список) Добавлен новый сервис с методом ContentCreatorInsightsService.GenerateCreatorInsights , который позволяет пользователям получать информацию о лучших авторах YouTube. Это позволяет клиентам искать авторов по комбинации таргетинга на аудиторию и контент или получать информацию об авторах по списку идентификаторов каналов YouTube.
  • Обновления AudienceInsightsService.GenerateSuggestedTargetingInsights :
    • audience , baseline_audience и data_month перемещены в audience_definition .
    • Добавлена audience_description для генерации предложений по таргетингу из текстового описания в свободной форме с использованием Gen AI.
  • Добавлен AudienceInsightsService.GenerateTargetingSuggestionMetrics , который возвращает потенциальные показатели охвата для заданных комбинаций таргетинга на аудиторию.

Рекомендации

Отчетность

  • Поля summary_row_setting и return_total_results_count в SearchGoogleAdsRequest заменены на поле search_settings , тип которого — SearchSettings , со следующими полями:
    • omit_results
    • return_summary_row
    • return_total_results_count
  • Добавлены следующие новые показатели по общим недействительным кликам, например, созданным ботами или сканерами, а также по нестандартным шаблонам. Их можно запросить в отчете campaign .
  • В QuotaError добавлены следующие значения:
    • EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION
    • EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION

v17.1.0 (07.08.2024)

Следующие новые функции и обновления были добавлены в v17_1.

Ресурсы

Аудитории

  • Новые значения перечисления в UserListCustomerTypeCategory :
    • LOYALTY_TIER_1_MEMBERS
    • LOYALTY_TIER_2_MEMBERS
    • LOYALTY_TIER_3_MEMBERS
    • LOYALTY_TIER_4_MEMBERS
    • LOYALTY_TIER_5_MEMBERS
    • LOYALTY_TIER_6_MEMBERS
    • LOYALTY_TIER_7_MEMBERS

Кампании

История изменений

  • Новый тип ресурса статуса изменения: ASSET_GROUP .

Конверсии

Планирование

  • AudienceInsights.GenerateAudienceOverlapInsights() , который принимает входной основной атрибут и набор атрибутов аудитории и возвращает оценки перекрытия потенциального охвата YouTube между основным атрибутом и атрибутами аудитории.

Отчетность

Видео

v17 (05.06.2024)

Следующие функции и изменения были добавлены в v17.

Объявления

  • Удален AdService.getAd . Это приводит AdService в соответствие с другими сервисами Google Ads API. Рекомендуемый способ получения рекламы и других типов ресурсов см. в разделе «Извлечение объектов» .
  • Добавлены дополнительные проверки для ImageAdInfo.image_asset относительно размеров и формата. Если изображение недействительно, могут возникнуть следующие ошибки:

Ресурсы

Аудитории

Пакетные задания

Кампании

  • Обнаружение переименовано в Генерирование спроса во всех полях, перечислениях и ошибках всех ресурсов в API Google Рекламы, таких как кампании, объявления и активы. Например, AdvertisingChannelType.DISCOVERY теперь называется AdvertisingChannelType.DEMAND_GEN .
  • Добавлен Campaign.keyword_match_type , позволяющий установить тип соответствия ключевых слов для всех ключевых слов в кампании.

Конверсии

Критерии

  • В следующие поля AdGroupCriterion добавлено, чтобы показать, выполняется ли критерий группы объявлений или причины, по которым он не показывается:
    • primary_status
    • primary_status_reasons
  • Добавлена ​​поддержка metrics.search_impression_share для gender_view
  • Добавлена ​​поддержка metrics.phone_calls для keyword_view

Местные услуги

Отчетность

Шоппинг

  • Добавлен новый отчет shopping_product , который соответствует странице «Товары» в пользовательском интерфейсе Google Рекламы. Он поддерживает возврат данных о текущем состоянии продуктов из учетных записей Google Merchant Center, связанных с учетной записью Google Рекламы.

Единые цели

Видео

  • В ContentLabelType добавлены следующие значения. Вы можете исключить эти ContentLabelTypes на уровне клиента:
    • BRAND_SUITABILITY_CONTENT_FOR_FAMILIES
    • BRAND_SUITABILITY_GAMES_FIGHTING
    • BRAND_SUITABILITY_GAMES_MATURE
    • BRAND_SUITABILITY_HEALTH_SENSITIVE
    • BRAND_SUITABILITY_HEALTH_SOURCE_UNDETERMINED
    • BRAND_SUITABILITY_NEWS_RECENT
    • BRAND_SUITABILITY_NEWS_SENSITIVE
    • BRAND_SUITABILITY_NEWS_SOURCE_NOT_FEATURED
    • BRAND_SUITABILITY_POLITICS
    • BRAND_SUITABILITY_RELIGION
  • Добавлен AdVideoAsset.ad_video_asset_info для поддержки настроек инвентаря для видеоресурсов при создании DemandGenVideoResponsiveAdInfo .
  • (Только учетные записи из белого списка) Campaign.video_brand_safety_suitability изменен.

Архивированные примечания к выпуску

Архивные примечания к выпуску см. в разделе «Устаревшие версии» .