Google Developers Japan: Google Ads API v17 のお知らせ

Local blog for Japanese speaking developers

Google Ads API v17 のお知らせ

2024年7月29日月曜日

この記事は Thanet Knack Praneenararat による Google Ads Developer Blog の記事 "Announcing v17 of the Google Ads API" を元に翻訳・加筆したものです。詳しくは元記事をご覧ください。この度、Google Ads API の v17 リリースをお知らせします。v17 の一部の機能を使用するには、クライアントライブラリとクライアントのコードをアップグレードする必要があります。更新版のクライアントライブラリとコードサンプルは、来週公開されます。主な機能は以下のとおりです。

2024 年 6 月 17 日に行われるリソース使用ポリシーの変更への準備として、QuotaError に 2 つの新しい値を追加しました。このエラーは、GoogleAdsService.Search() と GoogleAdsService.SearchStream() リクエストのクエリパターンにおいて、一定期間内に過度のリソース消費が発生した場合にスローされます。

page_size フィールドは常に 10,000 に設定され、GoogleAdsService.Search に page_size を渡すことはできなくなります。これを行うと、RequestError.PAGE_SIZE_NOT_SUPPORTED エラーが発生します。

campaign_aggregate_asset_view と channel_aggregate_asset_view を追加し、P-MAX キャンペーンと検索キャンペーンで報告される指標を増やせるようにしました。

バッチ処理を次のように変更します。

BatchJobService を使う際に、MutateOperation.asset_group_operation を設定できるようにしました。これにより、バッチ処理で P-MAX キャンペーン全体を作成して管理できるようになります。
BatchJobError.REQUEST_TOO_LARGE エラーを追加しました。これは、10,484,504 バイトを超える AddBatchJobOperationsRequest を送信すると発生します。オペレーションを小さなグループに分割し、別のリクエストとして送信する必要があります。

Campaign.keyword_match_type を追加し、キャンペーンのすべてのキーワードにキーワードのマッチタイプを設定できるようにしました。

AdService.getAd を削除し、Google Ads API の他のサービスと一致させました。リソースをフェッチする際の推奨事項は、オブジェクトの取得を参照してください。

AdGroupCriterion に primary_status と primary_status_reasons を追加し、広告グループの基準が利用されているかどうか、利用されていない場合はその理由を表示できるようにしました。

新しいレポート shopping_product を追加しました。これは、Google 広告 UI の [ 商品 ] ページに対応します。

サイズや形式に関する ImageAdInfo.image_asset の検証が追加されました。これにより、Google Ads API の他の画像検証との一貫性が向上します。

segments.sk_ad_network_redistributed_fine_conversion_value を追加しました。これは、最新の SkAdNetwork のポストバックデータの機械学習モデルに基づき、NULL 値を他の値に再分配します。

Google Ads API のすべてのリソースのすべてのフィールド、列挙型、エラーの名称で Discovery を Demand Gen に変更しました。

product_link をクエリする際には、1 つの リンクされた商品に関連するフィールドのみを選択できます。このようになっていない場合は、QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE がスローされます。

UserListCustomerTypeService.MutateUserListCustomerTypes() を追加し、オーディエンスの顧客タイプを設定できるようにしました。このメソッドは、CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings の使用に代わるものです。

local_services_verification_artifact に 2 つの expiration_date_time フィールドを追加し、広告主がアーティファクトの有効期限を適切に監視できるようにしました。

さらに詳しく知りたい方へ以下のリソースが役立ちます。

リリースノート

リファレンス

v16 と v17 の差分

ご質問やさらにサポートが必要なことがありましたら、フォーラムからご連絡ください。
Posted by Thanet Knack Praneenararat - Ads Developer Relations Team

ラベル

ブログアーカイブ

2024
- 11月
- 10月
- 9月
- 8月
- 7月
- 6月
- 5月
- 4月
- 3月
- 2月
- 1月

2023
- 12月
- 11月
- 10月
- 9月
- 8月
- 7月
- 6月
- 5月
- 4月
- 3月
- 2月
- 1月

2022
- 12月
- 11月
- 10月
- 9月
- 8月
- 7月
- 6月
- 5月
- 4月
- 3月
- 2月
- 1月

2021
- 12月
- 11月
- 10月
- 9月
- 8月
- 7月
- 6月
- 5月
- 4月
- 3月
- 2月
- 1月

2020
- 12月
- 11月
- 10月
- 9月
- 8月
- 7月
- 6月
- 5月
- 4月
- 3月
- 2月
- 1月

2019
- 12月
- 11月
- 10月
- 9月
- 8月
- 7月
- 6月
- 5月
- 4月
- 3月
- 2月
- 1月

2018
- 12月
- 11月
- 10月
- 9月
- 8月
- 7月
- 6月
- 5月
- 4月
- 3月
- 2月
- 1月

2017
- 12月
- 11月
- 10月
- 9月
- 8月
- 7月
- 6月
- 5月
- 4月
- 3月
- 2月
- 1月

2016
- 12月
- 11月
- 10月
- 9月
- 8月
- 7月
- 6月
- 5月
- 4月
- 3月
- 2月
- 1月

2015
- 12月
- 11月
- 10月
- 9月
- 8月
- 7月
- 6月
- 5月
- 4月
- 3月
- 2月

2014
- 12月
- 11月
- 10月
- 9月
- 8月
- 7月
- 6月
- 5月
- 4月
- 3月
- 2月
- 1月

2013
- 12月
- 11月
- 10月
- 9月
- 8月
- 7月
- 6月
- 5月
- 4月
- 3月
- 2月
- 1月

2012
- 12月
- 11月
- 10月
- 9月
- 8月
- 7月
- 6月
- 5月
- 4月
- 3月
- 2月
- 1月

2011
- 12月
- 11月
- 10月
- 9月
- 8月
- 7月
- 6月
- 5月
- 4月
- 3月
- 2月
- 1月

2010
- 12月
- 11月

Feed

"プロダクトに関するご意見はプロダクトフォーラムにお願いします"

Google
Privacy
Terms