最新バージョンにアップグレードする

Google Ads API の古いメジャー バージョンから新しいメジャー バージョンに定期的にアップグレードすることをおすすめします。その原因としては、バージョンが廃止しようとしていることや 新機能を使用することが考えられます。常に最新バージョンにアップグレードすることをおすすめします。

アップグレードの計画については、サポート終了スケジュールをご覧ください。バージョニングの仕組みについては、バージョニング ガイドをご覧ください。

アップグレードのプロセスを開始する際は、以下のチェックリストをご覧ください。

  1. メジャー バージョンを変更すると、エンドポイントが変更されます。最新のエンドポイントを使用するようにクライアント ライブラリを更新します。
  2. リリースノートで、各リリースで導入された変更をご確認ください。
  3. 以下の表で、アップグレードするバージョンで注力すべき領域を確認します。

2 つのバージョンの proto の差分に基づく変更の概要については、差分テーブルをご覧ください。

v15 ～ v16

サービスとそのコンポーネントの変更
AccountLink linked_account の data_partner リンクと google_ads リンクが削除されました。代わりに ProductLinkService と ProductLinkInvitationService を使用してください。
CampaignLifecycleGoal 以前に既存の CampaignLifecycleGoal を更新する場合は、特定の要件を指定して create オペレーションを発行します。これで、他のリソースタイプと同様に update オペレーションを発行できるようになりました。
エラー報告 一般的な ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT エラーが返された 2 つのケースで、より具体的なエラー メッセージが返されるようになりました。
  • CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT
  • CampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS
AudienceInsightsAttributeMetadata score フィールドが削除されました。
KeywordMatchTypeRecommendation キーワードのマッチタイプが設定されていない場合、API は recommended_match_type フィールドに対して UNKNOWN ではなく UNSPECIFIED を返すようになりました。

v14 ～ v15

サービスとそのコンポーネントの変更
AssetGroupListingGroupFilter vertical 列挙型フィールドの名前が feed_type に変更されました。
MediaFileService このサービスは不要になったため削除されました。以下の ImageAdInfo の変更をご覧ください。
ImageAdInfo media_file フィールドが image_asset に置き換えられました。
MerchantCenterLinkService このサービスは、 ProductLinkInvitationService と ProductLinkService に置き換えられました。
Campaign.ShoppingSetting sales_country フィールドが削除されました。情報が feed_label フィールドに返されるようになりました。
ProductBiddingCategoryConstant ProductCategoryConstant に置き換えられました。 それに応じて複数のフィールドの名前が変更されました。次の 3 つの変更をご覧ください。
ListingDimensionInfo product_bidding_category フィールドを product_category に置き換えました。
ListingGroupFilterDimension product_bidding_category フィールドを product_category に置き換えました。
shopping_performance_view レポート 以下のセグメント フィールド:
  • product_bidding_category_level1
  • product_bidding_category_level2
  • product_bidding_category_level3
  • product_bidding_category_level4
  • product_bidding_category_level5
が以下の内容に置き換えられました。
  • product_category_level1
  • product_category_level2
  • product_category_level3
  • product_category_level4
  • product_category_level5
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 に統合されました。