v19(2025 年 2 月 26 日)
v19 では、次の機能と変更が追加されました。
アカウント管理
- 今後の変更に対応するため、
CustomerError
に次の値を追加しました。CREATION_DENIED_FOR_POLICY_VIOLATION
CREATION_DENIED_INELIGIBLE_MCC
広告
- デマンド ジェネレーション広告でアスペクト比 9:16 の縦向き画像アセットをサポートするために、
DemandGenMultiAssetAdInfo.tall_portrait_marketing_images
を追加しました。
アセット
- (許可リストに登録されたアカウントのみ)
Asset.business_message_asset
、BusinessMessageAsset
、および次の列挙型とエラーを介してメッセージ アセットのサポートを追加しました。- 列挙型:
- ランディング ページのプレビューの自動生成をサポートするために
AssetAutomationType.GENERATE_LANDING_PAGE_PREVIEW
を追加しました。 - デマンド ジェネレーション動画レスポンシブ広告で、
AssetAutomationType.GENERATE_SHORTER_YOUTUBE_VIDEOS
がデフォルトで有効になりました。 - (許可リストに登録されたアカウントのみ。許可リストは現在閉鎖中)
Asset.app_deep_link_asset
とAppDeepLinkAsset
を追加しました。
コンバージョン数
- コンバージョン目標
LifecycleGoalValueSettings.high_lifetime_value
はベータ版を卒業し、変更可能になりました。CustomerLifecycleGoal.owner_customer
を追加して、顧客ライフサイクル目標を所有する顧客のリソース名を表示しました。
ConversionActionType.SALESFORCE
を非推奨にしました。
フィード
Feed
、FeedMapping
、FeedService
、AdGroupFeed
、feed_placeholder_view
など、フィード関連のエンティティをすべて削除しました。同じ目的を達成するには、アセットを使用する必要があります。削除されたすべてのエンティティの一覧については、移行に関する注意事項をご覧ください。
ホテル、旅行
- 値として 0 を指定できるように、
optional
フィールドのValueRuleItineraryAdvanceBookingWindow
のmin_days
とmax_days
を変更しました。これにより、当日の旅行検索をターゲティングできます。
P-MAX
- (許可リストに登録されているアカウントのみ)ブランド ガイドライン
- P-MAX キャンペーンの作成時にのみ
Campaign.brand_guidelines_enabled
を変更可能にしました。 - これは、旅行関連の目標達成のための P-MAX と互換性がありません。
- 既存の P-MAX キャンペーンでブランド ガイドラインを有効にするには、新しく追加された
CampaignService.EnablePMaxBrandGuidelines
を使用します。ブランド ガイドラインの無効化はサポートされていません。 - ブランドの色とフォント ファミリーを設定できるように、
Campaign.brand_guidelines
とBrandGuidelines
を追加しました。 - 新しいエラー値:
BatchJobError.CAMPAIGN_AND_CAMPAIGN_ASSET_TRANSACTION_FAILURE
BrandGuidelinesMigrationError
BRAND_GUIDELINES_ALREADY_ENABLED
CANNOT_ENABLE_BRAND_GUIDELINES_FOR_REMOVED_CAMPAIGN
BRAND_GUIDELINES_LOGO_LIMIT_EXCEEDED
CANNOT_AUTO_POPULATE_BRAND_ASSETS_WHEN_BRAND_ASSETS_PROVIDED
AUTO_POPULATE_BRAND_ASSETS_REQUIRED_WHEN_BRAND_ASSETS_OMITTED
TOO_MANY_ENABLE_OPERATIONS
CampaignError
BRAND_GUIDELINES_NOT_ENABLED_FOR_CAMPAIGN
BRAND_GUIDELINES_MAIN_AND_ACCENT_COLORS_REQUIRED
BRAND_GUIDELINES_COLOR_INVALID_FORMAT
BRAND_GUIDELINES_UNSUPPORTED_FONT_FAMILY
BRAND_GUIDELINES_UNSUPPORTED_CHANNEL
CANNOT_ENABLE_BRAND_GUIDELINES_FOR_TRAVEL_GOALS
CUSTOMER_NOT_ALLOWLISTED_FOR_BRAND_GUIDELINES
- P-MAX キャンペーンの作成時にのみ
AssetAutomationType.GENERATE_ENHANCED_YOUTUBE_VIDEOS
を追加し、P-MAX キャンペーンの拡張動画アセットの自動生成をサポートしました。
計画
- (許可リストに登録されたアカウントのみ)
ContentCreatorInsightsService.GenerateTrendingInsights
を追加しました。これにより、ユーザーは特定のオーディエンス定義に基づいて YouTube の急上昇コンテンツのトピックを確認できるようになります。 - 指定した条件で検索する国を指定するための
GenerateCreatorInsightsRequest.country_locations[]
を追加しました GenerateCreatorInsightsRequest.search_brand
を追加して、クリエイターを検索するブランドを指定できるようにしましたsearch_channels
リクエストの追加のチャンネル情報を提供するために、YouTubeChannelInsights
に新しいフィールドを追加しました。channel_url
channel_description
top_videos
AudienceInsightsAttributeMetadata
に新しいメタデータ フィールドを追加しました。youtube_video_metadata
user_interest_attribute_metadata
knowledge_graph_attribute_metadata
動画
DataLinkService.CreateDataLink
のリリースに伴い、以前に作成したデータリンクを変更できるように、次のメソッドを追加しました。RemoveDataLink
: Google 広告アカウントのデータリンクを削除するUpdateDataLink
: Google 広告アカウントでデータリンクを承認、拒否、取り消す
- 次の列挙型から
VIDEO_OUTSTREAM
のサポートを削除しました。
v18(2024 年 10 月 16 日)
v18 では、次の新機能とアップデートが追加されました。
アカウント管理
- (許可リストに登録されているアカウントのみ)
DataLinkService.CreateDataLink
を追加しました。これにより、クリエイターの YouTube チャンネルでホストされているクリエイター動画に Google 広告アカウントをリンクできるようになりました。動画をリンクすると、Google 広告アカウントでクリエイター動画を使用してパートナーシップ広告を配信できるようになります。
広告グループ
AdGroup.exclude_demographic_expansion
を追加しました。これにより、optimized_targeting_enabled
がtrue
の場合に、ユーザー属性の展開を除外できます。この機能は、以前はデマンド ジェネレーションでのみサポートされていました。
広告
AdGroupAd.ad_group_ad_asset_automation_settings
を追加しました。これにより、広告でアセットの自動生成を有効または無効にできます。AssetAutomationType
に次の値を追加しました。GENERATE_VERTICAL_YOUTUBE_VIDEOS
GENERATE_SHORTER_YOUTUBE_VIDEOS
AdNetworkType.GOOGLE_OWNED_CHANNELS
を追加しました。これは、YouTube、Gmail、Discover フィードなどの Google 所有のチャネルで配信される広告で使用されます。
アセット
AssetType.DISCOVERY_CAROUSEL_CARD
の名前をAssetType.DEMAND_GEN_CAROUSEL_CARD
に変更しました。
キャンペーン
metrics.store_visits_last_click_model_attributed_conversions
を追加しました。これは、キャンペーンのラストクリック モデルによってアトリビューションされた来店数を返します。- キャンペーンの動画視聴関連の指標に、以下の指標を追加しました。
metrics.results_conversions_purchase
を追加しました。これは、キャンペーンの統一目標の結果の購入コンバージョンを返します。DemandGenCampaignSettings.upgraded_targeting
のデフォルト値をfalse
からtrue
に変更しました。
Criterion
- ディスプレイ キャンペーン、デマンド ジェネレーション キャンペーン、動画キャンペーンのターゲット設定されたコンテンツのパフォーマンス指標(キーワード、プレースメント、トピックなど)を返す
content_criterion_view
を追加しました。
ホテル、旅行
- 検索広告の旅行フィードのサポート
ClickType.TRAVEL_ASSETS
を追加し、検索広告の旅行フィードの指標をセグメント化できるようにしました。- 検索広告の旅行フィードの使用のオプトインとオプトアウトに使用できる
AssetSetType.TRAVEL_FEED
を追加しました。
- (許可リストに登録されているアカウントのみ)旅行プランを新しいコンバージョン値のルールとして追加し、次の新しいフィールドと値を追加しました。
ConversionValueRule.itinerary_condition
をValueRuleItineraryCondition
に置き換え、予約可能期間、旅行プランの長さ、旅行開始曜日を指定できるようにします。ConversionValueRulePrimaryDimensionEnum.ITINERARY
ValueRuleSetDimension.ITINERARY
- ホテル キャンペーンと検索キャンペーンの特定の所在地(都市、国、地域)に基づいてパフォーマンス データを分割できるように、
campaign
レポートとad_group
レポートに次のセグメントを追加しました。
ローカル サービス
- 特定のローカル サービスの見込み顧客との会話に通話録音が存在しない場合、
PhoneCallDetails.call_recording_url
は空になります。無効な URL は指定されません。 Campaign.local_services_campaign_settings
でカテゴリの目標コンバージョン単価を設定できるCategoryBid.target_cpa_bid_micro
を追加しました。
P-MAX
- ブランド ガイドラインのサポート
- 特定の P-MAX キャンペーンでブランド ガイドラインが有効になっているかどうかを示す
Campaign.brand_guidelines_enabled
を追加しました。有効にした場合、field_type
がBUSINESS_NAME
、LOGO
、LANDSCAPE_LOGO
に設定されているアセットは、AssetGroupAsset
リソースではなく、CampaignAsset
リソースとしてリンクする必要があります。 CampaignError.REQUIRED_BUSINESS_NAME_ASSET_NOT_LINKED
エラーとCampaignError.REQUIRED_LOGO_ASSET_NOT_LINKED
エラーを追加しました。これは、ブランド ガイドラインが有効になっている P-MAX キャンペーンに、必要なCampaignAsset
リソースがリンクされていないことを示します。- ブランド ガイドラインが有効になっている場合、
field_type
がBUSINESS_NAME
に設定されたアセットと、LOGO
が設定されたアセットを 1 つ以上、CampaignAsset
リソースとしてキャンペーンにリンクする必要があります。商品フィードを使用してオンライン販売促進を目指す P-MAX キャンペーンでは、キャンペーンのアセット グループにリンクされているアセットがある場合にのみ、この要件を満たす必要があります。 AssetLinkError
に次の値を追加しました。BRAND_ASSETS_NOT_LINKED_AT_ASSET_GROUP_LEVEL
: ブランド ガイドラインが有効になっていないP-MAX キャンペーンで、ブランド アセットをAssetGroupAsset
リソースではなくCampaignAsset
リソースとしてキャンペーンにリンクしようとするとスローされます。BRAND_ASSETS_NOT_LINKED_AT_CAMPAIGN_LEVEL
エラー: ブランド ガイドラインが有効になっている P-MAX キャンペーンで、ブランド アセットをCampaignAsset
リソースではなくAssetGroupAsset
リソースとしてキャンペーンにリンクしようとすると発生します。
- 特定の P-MAX キャンペーンでブランド ガイドラインが有効になっているかどうかを示す
- P-MAX 広告が配信されたプレースメントのインプレッションを返す
performance_max_placement_view
が追加されました。 AssetGroupListingGroupFilterError.TREE_WAS_INVALID_BEFORE_MUTATION
を追加しました
計画
- (許可リストに登録されたアカウントのみ)メソッド
ContentCreatorInsightsService.GenerateCreatorInsights
を使用して新しいサービスを追加しました。これにより、ユーザーはトップ YouTube クリエイターに関する分析情報を確認できるようになります。これにより、オーディエンス ターゲティングとコンテンツ ターゲティングの組み合わせを指定してクリエイターを検索したり、YouTube チャンネル ID のリストを指定してクリエイターの分析情報を取得したりできます。 AudienceInsightsService.GenerateSuggestedTargetingInsights
の更新:audience
、baseline_audience
、data_month
をaudience_definition
に移動しました。- 生成 AI を使用して自由形式のテキスト記述からターゲティング候補を生成する
audience_description
を追加しました。
- 特定のオーディエンス ターゲティングの組み合わせの潜在リーチ指標を返す
AudienceInsightsService.GenerateTargetingSuggestionMetrics
を追加しました。
推奨事項
RecommendationService.GenerateRecommendations
を使用して、キャンペーンの作成時に最適化された予算の候補に関する最適化案を生成できるようになりました。GenerateRecommendationsRequest.recommendation_types[]
に最適化案のタイプCAMPAIGN_BUDGET
を含める必要があります。これは、P-MAX キャンペーンと検索キャンペーンで使用できます。
レポート
SearchGoogleAdsRequest
のsummary_row_setting
フィールドとreturn_total_results_count
フィールドを、型がSearchSettings
のsearch_settings
フィールドに置き換え、次のフィールドを追加しました。omit_results
return_summary_row
return_total_results_count
- bot やクローラーによって生成されたクリックや、不規則なパターンを持つクリックなど、一般的な無効なクリックに関する次の新しい指標が追加されました。
campaign
レポートでクエリできます。 QuotaError
に次の値を追加しました。EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION
EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION
v17.1.0(2024 年 8 月 7 日)
v17_1 では、次の新機能とアップデートが追加されました。
アセット
AdGroupAdService.RemoveAutomaticallyCreatedAssets()
を使用すると、レスポンシブ検索広告にリンクされている特定の自動作成アセットを削除できます。
オーディエンス
UserListCustomerTypeCategory
の新しい列挙値:LOYALTY_TIER_1_MEMBERS
LOYALTY_TIER_2_MEMBERS
LOYALTY_TIER_3_MEMBERS
LOYALTY_TIER_4_MEMBERS
LOYALTY_TIER_5_MEMBERS
LOYALTY_TIER_6_MEMBERS
LOYALTY_TIER_7_MEMBERS
キャンペーン
ShareablePreviewService.GenerateShareablePreviews()
は、有効または一時停止中のアセット グループの共有可能な広告プレビューの URL(レスポンスのshareable_preview_url
)を生成します。expiration_date_time
フィールドには、レスポンスの URL の有効期限が示されます。- エラーが発生した場合、このメソッドは URL ではなく
partial_failure_error
を返します。
変更履歴
- 新しい変更ステータス リソースタイプ:
ASSET_GROUP
。
コンバージョン数
- SKAdNetwork バージョンの新しいセグメント フィールド:
segments.sk_ad_network_version
offline_conversion_upload_conversion_action_summary
: コンバージョン アップロードの診断をコンバージョン アクション単位で表示します。- オフライン診断レポートには、処理中のアップロード済みコンバージョンの数を示す次の指標が追加されます。
計画
AudienceInsights.GenerateAudienceOverlapInsights()
: 入力プライマリ属性とオーディエンス属性のコレクションを受け取り、プライマリ属性とオーディエンス属性の間で YouTube の潜在的なリーチの重複を推定します。
レポート
segments.date
に基づくper_store_view
のセグメンテーションのサポート
動画
- レポート(
ad_group
、campaign
など)を使用して、動画キャンペーンの次の標準入札戦略に関連する情報を取得する機能のサポート:Campaign.fixed_cpm
(固定 CPM(インプレッション単価))Campaign.target_cpv
(目標広告視聴単価(CPV))
Campaign.video_campaign_settings
: 次のレポート フィールドを使用して、動画広告を表示できる広告枠を特定できます。segments.ad_format_type
: 動画広告フォーマットのタイプに基づいて、次のレポートをセグメント化できます。
v17(2024 年 6 月 5 日)
v17 では、次の機能と変更が追加されました。
広告
AdService.getAd
を削除しました。これにより、AdService
は Google Ads API の他のサービスと整合するようになります。広告や他のリソースタイプを取得する推奨の方法については、オブジェクトの取得をご覧ください。- サイズと形式に関する
ImageAdInfo.image_asset
の検証を追加しました。画像が無効な場合、次のエラーがスローされることがあります。
アセット
- 新しい列挙型
ClickType.AD_IMAGE
を追加しました。 - P-MAX キャンペーンと検索キャンペーンの新しい指標を含む、次の新しいレポートを追加しました。
オーディエンス
バッチジョブ
BatchJobError.REQUEST_TOO_LARGE
を追加しました。送信されたAddBatchJobOperationsRequest
が 10484504 バイトを超えるとスローされます。BatchJobService
の使用時にMutateOperation.asset_group_operation
を設定するサポートを追加しました。これにより、バッチ処理を使用して P-MAX キャンペーン全体を作成、管理できます。新しい専用ガイドをご覧ください。
キャンペーン
- Google Ads API のすべてのリソース(キャンペーン、広告、アセットなど)のすべてのフィールド、列挙型、エラーで、[Discovery] を [Demand Gen] に変更しました。たとえば、
AdvertisingChannelType.DISCOVERY
はAdvertisingChannelType.DEMAND_GEN
になりました。 Campaign.keyword_match_type
を追加し、キャンペーン内のすべてのキーワードにキーワードのマッチタイプを設定できるようにしました。
コンバージョン数
- SKAdNetwork コンバージョンの場合、
segments.sk_ad_network_conversion_value
の名前をsegments.sk_ad_network_fine_conversion_value
に変更しました。segments.sk_ad_network_redistributed_fine_conversion_value
を追加しました。
- 次の指標は、ゼロの場合でもレスポンスで返されるようになりました。これにより、他の指標との整合性が保たれます。
条件
- 広告グループの条件が配信されているかどうか、配信されていない理由を示すフィールドを
AdGroupCriterion
に追加しました。primary_status
primary_status_reasons
gender_view
のmetrics.search_impression_share
のサポートを追加しました。keyword_view
のmetrics.phone_calls
のサポートを追加しました。
ローカル サービス
- 新しい
LocalServicesLeadConversation
をLocalServicesLead
に追加するために使用されるLocalServicesLeadService.AppendLeadConversation()
を追加しました。これにより、見込み顧客の作成方法に応じて、SMS などの適切なチャネルを通じてユーザーにメッセージが送信されます。AppendLeadConversationRequest.conversations
のサイズは 1,000 に制限されています。Conversation.local_services_lead
で指定できるのは、lead_type
がLeadType.MESSAGE
に設定されたLocalServicesLead
のみです。
ConversationType
に新しい列挙値を追加しました。WHATSAPP
: WhatsApp で開始された会話を表します。ADS_API
: 新しいLocalServicesLeadService.AppendLeadConversation()
メソッドを使用して開始された会話を表します。
local_services_verification_artifact
に次の新しいフィールドを追加しました。local_services_verification_artifact.insurance_verification_artifact.expiration_date_time
local_services_verification_artifact.license_verification_artifact.expiration_date_time
レポート
product_link
をクエリするときに、リンクされた商品の 1 つに関連するフィールドのみを選択できるようになりました。複数のリンクされたプロダクトの複数のフィールドを選択すると、QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE
がスローされます。たとえば、product_link.advertising_partner.customer
とproduct_link.data_partner.data_partner_id
を同じクエリで選択することはできません。page_size
をGoogleAdsService.Search
に渡すと、RequestError.PAGE_SIZE_NOT_SUPPORTED
エラーが発生します。
ショッピング
- Google 広告管理画面の [商品] ページに対応する新しいレポート
shopping_product
を追加しました。Google 広告アカウントにリンクされた Google Merchant Center アカウントの商品の現在の状態に関するデータの返却がサポートされています。GoogleAdsService.Search
またはGoogleAdsService.SearchStream
を使用する場合は、segments.date
を使用してshopping_product
レポートの指標をフィルタできます。日付によるセグメンテーションは許可されていません。ShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION
エラーが返されます。
統合された目標
- オーディエンスの顧客タイプを構成するための
UserListCustomerTypeService.MutateUserListCustomerTypes()
を追加しました。 CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings
が削除されました。顧客ライフサイクル目標のオーディエンス設定を構成するには、代わりにUserListCustomerTypeService.MutateUserListCustomerTypes()
を使用します。- ユーザーリストを接続または接続解除するには、
UserListCustomerType.customer_type_category
をUserListCustomerTypeCategory.PURCHASERS
に設定して、顧客ライフサイクル目標の既存の顧客定義にそれぞれ含めるか除外します。詳しくは、オーディエンスをセグメント化をご覧ください。
- ユーザーリストを接続または接続解除するには、
動画
ContentLabelType
に次の値を追加しました。これらのContentLabelTypes
は、お客様単位で除外できます。BRAND_SUITABILITY_CONTENT_FOR_FAMILIES
BRAND_SUITABILITY_GAMES_FIGHTING
BRAND_SUITABILITY_GAMES_MATURE
BRAND_SUITABILITY_HEALTH_SENSITIVE
BRAND_SUITABILITY_HEALTH_SOURCE_UNDETERMINED
BRAND_SUITABILITY_NEWS_RECENT
BRAND_SUITABILITY_NEWS_SENSITIVE
BRAND_SUITABILITY_NEWS_SOURCE_NOT_FEATURED
BRAND_SUITABILITY_POLITICS
BRAND_SUITABILITY_RELIGION
DemandGenVideoResponsiveAdInfo
の作成時に動画アセットのインベントリ設定をサポートするために、AdVideoAsset.ad_video_asset_info
を追加しました。- (許可リストに登録されたアカウントのみ)
Campaign.video_brand_safety_suitability
を変更可能にしました。
リリースノートのアーカイブ
アーカイブされたリリースノートについては、サポートが終了したバージョンをご覧ください。