Время от времени вам может потребоваться обновить старую основную версию Google Ads API до более новой основной версии. Это может быть связано с тем, что версия устарела или вы хотите использовать новую функцию. Мы рекомендуем всегда обновляться до последней версии.
Ознакомьтесь с нашим графиком прекращения поддержки , чтобы спланировать обновления. Ознакомьтесь с нашим руководством по управлению версиями , чтобы узнать, как работает управление версиями.
Вот контрольный список, который поможет вам начать процесс обновления:
- Ваша конечная точка изменится при изменении основных версий. Обновите клиентские библиотеки , чтобы использовать новейшую конечную точку.
- Просмотрите примечания к выпуску , чтобы увидеть изменения, внесенные в каждый выпуск.
- В таблицах ниже указаны конкретные области, на которые следует обратить внимание при обновлении версии.
Полный обзор изменений, основанных на различиях между прототипами двух версий, можно найти в таблице различий .
с v15 по v16
Изменения в сервисах и их компонентах | |
---|---|
AccountLink | Ссылки data_partner и google_ads в linked_account удалены. Вместо этого используйте ProductLinkService и ProductLinkInvitationService . |
CampaignLifecycleGoal | Ранее при обновлении существующего CampaignLifecycleGoal вам нужно было выполнить операцию create с конкретными требованиями. Теперь вместо этого вы можете выполнить операцию update , как и в случае с другими типами ресурсов. |
Отчет об ошибках | Два случая, когда была возвращена общая ошибка ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT , теперь приводят к более конкретным сообщениям об ошибках:
|
AudienceInsightsAttributeMetadata | Поле score было удалено. |
KeywordMatchTypeRecommendation | Если тип соответствия ключевого слова не задан, API теперь возвращает UNSPECIFIED вместо UNKNOWN для поля recommended_match_type . |
с v14 по v15
Изменения в сервисах и их компонентах | |
---|---|
AssetGroupListingGroupFilter | Поле vertical перечисления было переименовано feed_type . |
MediaFileService | Услуга удалена, так как она больше не нужна. См. изменение ImageAdInfo ниже. |
ImageAdInfo | Поле media_file было заменено на image_asset . |
MerchantCenterLinkService | Служба была заменена на ProductLinkInvitationService и ProductLinkService . |
Campaign.ShoppingSetting | Поле sales_country было удалено. Информация теперь возвращается в feed_label . |
ProductBiddingCategoryConstant | Заменено на ProductCategoryConstant . Несколько полей были переименованы соответствующим образом, см. следующие три изменения ниже. |
ListingDimensionInfo | Поле product_bidding_category заменено на product_category . |
ListingGroupFilterDimension | Поле product_bidding_category заменено на product_category . |
отчет shopping_performance_view | Следующие поля сегмента:
|
Campaign.shopping_setting | Удалена поддержка создания поисковых кампаний с этим полем. |
CampaignCriterion.listing_scope | Удалена поддержка создания поисковых кампаний с этим полем. |
отчет sk_ad_network_conversions | metrics.sk_ad_network_conversions заменен на metrics.sk_ad_network_installs . |
OfflineConversionClientSummary | Поле offline_conversion_client_summaries перенесено из Customer в ресурс верхнего уровня, к которому можно запрашивать отдельно.Измените свой запрос с: SELECT customer.offline_conversion_client_summaries FROM customerдо: SELECT offline_conversion_upload_client_summary.client, offline_conversion_upload_client_summary.status, offline_conversion_upload_client_summary.total_event_count, offline_conversion_upload_client_summary.successful_event_count, offline_conversion_upload_client_summary.last_upload_date_time, ... FROM offline_conversion_upload_client_summary Используйте построитель запросов , чтобы изучить список доступных полей для выбора и фильтрации. |
OfflineConversionUploadAlert | Переименован в OfflineConversionAlert . |
OfflineConversionUploadError | Переименован в OfflineConversionError . |
AdNetworkType | Перечисления YOUTUBE_SEARCH и YOUTUBE_WATCH были объединены в одно перечисление: YOUTUBE . |