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

古いメジャー バージョンの Google Ads API から新しいメジャー バージョンに定期的にアップグレードすることをおすすめします。バージョンが廃止されようとしている、 新機能を使いたい場合などですおすすめの方法 常に最新バージョンにアップグレードしてください。

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

次のチェックリストを利用して、アップグレードを開始してください。

  1. メジャー バージョンを変更すると、エンドポイントが変更されます。最新のエンドポイントを使用するようにクライアント ライブラリを更新します。
  2. リリースノートで、Google Cloud の 各リリースで導入されました
  3. このバージョンで重点を置くべき分野については、以下の表をご覧ください 表示されます。

2 つのバージョンのプロトコルの差分に基づく変更の概要については、差分表をご覧ください。

v17 から v18

サービスとそのコンポーネントの変更
GoogleAdsService Search リクエストと SearchStream リクエスト

リクエストの費用が高すぎるためにリクエストがスロットリングされた場合のエラーは、QuotaError.RESOURCE_EXHAUSTED ではなく QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION または QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION になります。詳しくは、ブログ投稿をご覧ください。
GoogleAdsService summary_row_setting と SearchGoogleAdsRequest の return_total_results_count フィールド 新しい SearchSettings オブジェクトの一部になりました。
AssetType DISCOVERY_CAROUSEL_CARD 列挙値の名前が次のように変更されました。 DEMAND_GEN_CAROUSEL_CARD。これは以前の変更に沿っています して、ファインド キャンペーンの名前をデマンド ジェネレーション キャンペーンに変更します。
AudienceInsightsService.GenerateSuggestedTargetingInsights audience、baseline_audience、 data_month フィールドが audience_definition フィールド。
DemandGenCampaignSettings upgraded_targeting フィールドのデフォルト値が false から true に変更されました。
LocalServicesLeadConversation phone_call_details.call_recording_url フィールドは今後使用されなくなります。 静的呼び出しでは値が入力されます。

v16 ～ v17

サービスとそのコンポーネントの変更
GoogleAdsService Search リクエストと SearchStream リクエスト

クエリの費用が高すぎると、リクエストがスロットリングされることがあります。存在する場合は、QuotaError.RESOURCE_EXHAUSTED エラーが発生します。詳しくは、ブログ投稿をご覧ください。
GoogleAdsService Search リクエスト。

page_size を GoogleAdsService.Search に渡すと、RequestError.PAGE_SIZE_NOT_SUPPORTED エラーが発生します。
Campaign、nd Ad

AdvertisingChannelType が DISCOVERY のキャンペーンの AdvertisingChannelType が DEMAND_GEN に変更されました。

また、一部の広告では、レポート用にタイプとフィールド名が変更されます。

  • DISCOVERY_MULTI_ASSET_ADD は DEMAND_GEN_MULTI_ASSET_ADD になり、対応するレポート フィールド ad_group_ad.ad.discovery_multi_asset_ad は ad_group_ad.ad.demand_gen_multi_asset_ad になります。
  • DISCOVERY_CAROUSEL_AD は次の形式になります: DEMAND_GEN_CAROUSEL_AD と、対応するレポート フィールド 「ad_group_ad.ad.discovery_carousel_ad」は次の形式になります: ad_group_ad.ad.demand_gen_carousel_ad
  • DISCOVERY_VIDEO_RESPONSIVE_AD は DEMAND_GEN_VIDEO_RESPONSIVE_AD になり、対応するレポート フィールド ad_group_ad.ad.discovery_video_responsive_ad は ad_group_ad.ad.demand_gen_video_responsive_ad になります。
AdService GetAd エンドポイントは削除されます。これにより、AdService は Google Ads API の他のサービスと整合するようになります。広告やその他のリソースタイプを取得する推奨方法については、オブジェクトの取得に関するガイドをご覧ください。
CustomerLifecycleGoal と CampaignLifecycleGoal ライフサイクル目標のセグメントの管理方法が変更されました。セグメントを確認 ライフサイクル目標に関するドキュメントの「オーディエンス」セクションで 概要をご覧ください。
ProductLink GoogleAdsService の検索または検索ストリームの実行中 product_link のリクエストに対して、関連するフィールドのみを 1 つのリンク済みのプロダクトに 関連付けることができますリンクされたさまざまなサービスから複数のフィールドを選択する 結果に QuotaError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE エラーが発生します。
レポート metrics.sk_ad_network_conversion_value フィールドの名前を metrics.sk_ad_network_fine_conversion_value に変更しました。