2024 年 6 月 5 日（水曜日）
本日、Google Ads API の v17 のリリースを発表しました。v17 の一部の機能を使用するには、クライアント ライブラリとクライアント コードをアップグレードする必要があります。更新されたクライアント ライブラリとコードサンプルは、来週公開される予定です。主な内容は次のとおりです。
- 2024 年 6 月 17 日に実施されるリソース利用ポリシーの変更に備えて、
QuotaErrorに 2 つの新しい値を追加しました。これは、GoogleAdsService.Search()リクエストとGoogleAdsService.SearchStream()リクエストのクエリパターンによって、一定期間に過剰なリソース消費が発生した場合にスローされます。 page_sizeフィールドは常に 10,000 に設定され、page_sizeをGoogleAdsService.Searchに渡すことはできなくなりました。このような操作を行うと、RequestError.PAGE_SIZE_NOT_SUPPORTEDエラーが発生します。- P-MAX キャンペーンと検索キャンペーンのより多くの指標をレポートするために、
campaign_aggregate_asset_viewとchannel_aggregate_asset_viewを追加しました。 - バッチ処理の変更:
BatchJobServiceの使用時にMutateOperation.asset_group_operationを設定するサポートを追加しました。これにより、バッチ処理を使用して P-MAX キャンペーン全体を作成、管理できます。- 10,484,504 バイトを超える
AddBatchJobOperationsRequestを送信した場合のBatchJobError.REQUEST_TOO_LARGEエラーを追加しました。オペレーションを小さなグループに分割し、別のリクエストとして送信する必要があります。
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 を デマンド ジェネレーション に変更しました。
product_linkをクエリする際に、1 つのリンクされたサービスに関連するフィールドのみを選択できるようになりました。そうしないと、QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSEがスローされます。- オーディエンスの顧客タイプを構成する
UserListCustomerTypeService.MutateUserListCustomerTypes()を追加しました。このメソッドはCustomerLifecycleGoal.lifecycle_goal_customer_definition_settingsの代わりに使用します。 - 2 つの expiration_date_time フィールド
local_services_verification_artifactを追加し、広告主がアーティファクトの有効期限をより適切にモニタリングできるようにしました。
詳しい情報はどこで入手できますか？
以下のリソースが役に立ちます。
ご不明な点がある場合やサポートが必要な場合は、フォーラムからお問い合わせください。
- Google Ads API チーム、Thanet Knack Praneenararat
ラベル: google-ads-api、 release