pp-google-ads

Google 広告 — Printing Press CLI

前提条件：CLI のインストール

このスキルでは、google-ads-pp-cli バイナリを使用します。このスキルのコマンドを実行する前に、CLI がインストールされていることを必ず確認してください。 インストールされていない場合は、先にインストールします。

1. Printing Press インストーラーを使ってインストールします。バイナリの既定のインストール先は、macOS/Linux では $HOME/.local/bin、Windows では %LOCALAPPDATA%\Programs\PrintingPress\bin です。

   npx -y @mvanhorn/printing-press-library install google-ads --cli-only
   

2. 確認します：google-ads-pp-cli --version
3. スキルを実行するエージェント／ランタイムの $PATH に、表示されたインストール先が含まれていることを確認します。

npx でのインストールに失敗した場合（Node がない、オフラインなど）は、Go を直接インストールしてください（Go 1.26.6 以降が必要です）。

go install github.com/mvanhorn/printing-press-library/library/marketing/google-ads/cmd/google-ads-pp-cli@latest

インストール後に --version が「command not found」と表示する場合、ランタイムからバイナリのディレクトリを $PATH 経由で参照できていません。確認に成功するまで、スキルのコマンドを実行しないでください。

コマンドリファレンス

audience_insights — Google 広告のオーディエンスインサイト操作

• google-ads-pp-cli audience-insights — オーディエンスインサイトのデータをリクエストできる日付範囲を一覧表示します。

customers — Google 広告の顧客操作

• google-ads-pp-cli customers create-customer-client — マネージャー配下に新しいクライアントを作成します。新しいクライアント顧客が返されます。
• google-ads-pp-cli customers generate-ad-group-themes — 指定されたキーワードに対して、提案された広告グループと変更案（テキスト、マッチタイプ）のリストを返します。
• google-ads-pp-cli customers generate-audience-composition-insights — 関心のあるオーディエンスに含まれる属性のコレクションと、各属性を比較する指標を返します…
• google-ads-pp-cli customers generate-audience-overlap-insights — オーディエンス属性のコレクションと、各属性の潜在的な YouTube オーディエンスの重複に関する推定値を返します…
• google-ads-pp-cli customers generate-creator-insights — YouTube クリエイターとチャンネルのコレクションに関するインサイトを返します。
• google-ads-pp-cli customers generate-insights-finder-report — Insights Finder ツールで表示できる保存済みレポートを作成します。
• google-ads-pp-cli customers generate-keyword-forecast-metrics — 指定されたキャンペーンのキーワード予測指標（インプレッション数、クリック数、合計費用など）を返します。
• google-ads-pp-cli customers generate-keyword-historical-metrics — キーワードの過去の指標のリストを返します。
• google-ads-pp-cli customers generate-keyword-ideas — キーワード候補のリストを返します。
• google-ads-pp-cli customers generate-reach-forecast — 指定されたターゲティング／商品構成のリーチ予測を生成します。
• google-ads-pp-cli customers generate-shareable-previews — リクエストされた共有可能なプレビューを返します。
• google-ads-pp-cli customers generate-suggested-targeting-insights — リクエストされたオーディエンスに関連するターゲティングインサイト（ターゲティング可能なオーディエンスなど）のコレクションを返します。
• google-ads-pp-cli customers generate-targeting-suggestion-metrics — ターゲティング可能なオーディエンスの潜在リーチ指標を返します。「何人の男性が…
• google-ads-pp-cli customers generate-trending-insights — YouTube でトレンドになっているコンテンツに関するインサイトを返します。
• google-ads-pp-cli customers get-identity-verification — 本人確認情報を返します。
• google-ads-pp-cli customers list-accessible-customers — 呼び出しを認証したユーザーが直接アクセスできる顧客のリソース名を返します。
• google-ads-pp-cli customers mutate — 顧客を更新します。操作のステータスが返されます。
• google-ads-pp-cli customers remove-campaign-automatically-created-asset — キャンペーンから自動作成されたアセットを削除します。
• google-ads-pp-cli customers search-audience-insights-attributes — インサイトの生成に使用できるオーディエンス属性を検索します。
• google-ads-pp-cli customers start-identity-verification — 指定された確認プログラムの種類で本人確認を開始します。ステータスが返されます。
• google-ads-pp-cli customers suggest-brands — この顧客について、プレフィックスに一致するブランドのリストを返す RPC です。
• google-ads-pp-cli customers suggest-keyword-themes — 広告掲載に使用するキーワードテーマを提案します。
• google-ads-pp-cli customers suggest-smart-campaign-ad — ターゲティングなどのデータポイントに基づいて、Ad リソースファミリーと互換性のあるスマートキャンペーン広告を提案します…
• google-ads-pp-cli customers suggest-smart-campaign-budget-options — 予算オプションの候補を返します。
• google-ads-pp-cli customers suggest-travel-assets — 旅行アセットの候補を返します。アセットの候補は可能な範囲で返されます。保証はありません…
• google-ads-pp-cli customers upload-call-conversions — 指定された電話コンバージョンを処理します。
• google-ads-pp-cli customers upload-click-conversions — 指定されたクリックコンバージョンを処理します。
• google-ads-pp-cli customers upload-conversion-adjustments — 指定されたコンバージョン調整を処理します。
• google-ads-pp-cli customers upload-user-data — 指定されたユーザーデータをアップロードします。

customers_account_budget_proposals — Google Ads の顧客アカウント予算提案操作

• google-ads-pp-cli customers-account-budget-proposals <customerId> — アカウント予算案を作成、更新、または削除します。操作ステータスが返されます。

customers_account_links — Google Ads の顧客アカウントリンク操作

• google-ads-pp-cli customers-account-links create — アカウントリンクを作成します。
• google-ads-pp-cli customers-account-links mutate — アカウントリンクを作成または削除します。V5 以降、AccountLinkService.MutateAccountLink... による作成はサポートされていません。

customers_ad_group_ad_labels — Google Ads の顧客広告グループ広告ラベル操作

• google-ads-pp-cli customers-ad-group-ad-labels <customerId> — 広告グループ広告ラベルを作成および削除します。操作ステータスが返されます。

customers_ad_group_ads — Google Ads の顧客広告グループ広告操作

• google-ads-pp-cli customers-ad-group-ads mutate — 広告を作成、更新、または削除します。操作ステータスが返されます。
• google-ads-pp-cli customers-ad-group-ads remove-automatically-created-assets — 広告から自動作成されたアセットを削除します。

customers_ad_group_asset_sets — Google Ads の顧客広告グループアセットセット操作

• google-ads-pp-cli customers-ad-group-asset-sets <customerId> — 広告グループアセットセットを作成または削除します。操作ステータスが返されます。

customers_ad_group_assets — Google Ads の顧客広告グループアセット操作

• google-ads-pp-cli customers-ad-group-assets <customerId> — 広告グループアセットを作成、更新、または削除します。操作ステータスが返されます。

customers_ad_group_bid_modifiers — Google Ads の顧客広告グループ入札単価調整操作

• google-ads-pp-cli customers-ad-group-bid-modifiers <customerId> — 広告グループの入札単価調整を作成、更新、または削除します。操作ステータスが返されます。

customers_ad_group_criteria — Google Ads の顧客広告グループ条件操作

• google-ads-pp-cli customers-ad-group-criteria <customerId> — 条件を作成、更新、または削除します。操作ステータスが返されます。

customers_ad_group_criterion_customizers — Google Ads の顧客広告グループ条件カスタマイザー操作

• google-ads-pp-cli customers-ad-group-criterion-customizers <customerId> — 広告グループ条件カスタマイザーを作成、更新、または削除します。操作ステータスが返されます。

customers_ad_group_criterion_labels — Google Ads の顧客広告グループ条件ラベル操作

• google-ads-pp-cli customers-ad-group-criterion-labels <customerId> — 広告グループ条件ラベルを作成および削除します。操作ステータスが返されます。

customers_ad_group_customizers — Google Ads の顧客広告グループカスタマイザー操作

• google-ads-pp-cli customers-ad-group-customizers <customerId> — 広告グループカスタマイザーを作成、更新、または削除します。操作ステータスが返されます。

customers_ad_group_labels — Google Ads の顧客広告グループラベル操作

• google-ads-pp-cli customers-ad-group-labels <customerId> — 広告グループラベルを作成および削除します。操作ステータスが返されます。

customers_ad_groups — Google Ads の顧客広告グループ操作

• google-ads-pp-cli customers-ad-groups <customerId> — 広告グループを作成、更新、または削除します。操作ステータスが返されます。

customers_ad_parameters — Google Ads の顧客広告パラメーター操作

• google-ads-pp-cli customers-ad-parameters <customerId> — 広告パラメーターを作成、更新、または削除します。操作ステータスが返されます。

customers_ads — Google Ads の顧客広告操作

• google-ads-pp-cli customers-ads <customerId> — 広告を更新します。操作ステータスが返されます。TextAd、ExpandedDynamicSearchAd,... の広告更新はサポートされていません。

customers_asset_generations — Google Ads の顧客アセット生成操作

• google-ads-pp-cli customers-asset-generations generate-images — 生成 AI を使用して、キャンペーンのアセットとして使用できる画像を生成します。

• google-ads-pp-cli customers-asset-generations generate-text — 生成 AI を使用して、キャンペーンのアセットとして使用できるテキストを生成します。 customers_asset_group_assets — Google Ads の顧客のアセットグループアセット操作

• google-ads-pp-cli customers-asset-group-assets <customerId> — アセットグループアセットを作成、更新、または削除します。操作のステータスが返されます。

customers_asset_group_listing_group_filters — Google Ads の顧客のアセットグループリスティンググループフィルター操作

• google-ads-pp-cli customers-asset-group-listing-group-filters <customerId> — アセットグループのリスティンググループフィルターを作成、更新、または削除します。操作のステータスが返されます。

customers_asset_group_signals — Google Ads の顧客のアセットグループシグナル操作

• google-ads-pp-cli customers-asset-group-signals <customerId> — アセットグループシグナルを作成または削除します。操作のステータスが返されます。

customers_asset_groups — Google Ads の顧客のアセットグループ操作

• google-ads-pp-cli customers-asset-groups <customerId> — アセットグループを作成、更新、または削除します。操作のステータスが返されます。

customers_asset_set_assets — Google Ads の顧客のアセットセットアセット操作

• google-ads-pp-cli customers-asset-set-assets <customerId> — アセットセットアセットを作成、更新、または削除します。操作のステータスが返されます。

customers_asset_sets — Google Ads の顧客のアセットセット操作

• google-ads-pp-cli customers-asset-sets <customerId> — アセットセットを作成、更新、または削除します。操作のステータスが返されます。

customers_assets — Google Ads の顧客のアセット操作

• google-ads-pp-cli customers-assets <customerId> — アセットを作成します。操作のステータスが返されます。

customers_audiences — Google Ads の顧客のオーディエンス操作

• google-ads-pp-cli customers-audiences <customerId> — オーディエンスを作成します。操作のステータスが返されます。

customers_batch_jobs — Google Ads の顧客のバッチジョブ操作

• google-ads-pp-cli customers-batch-jobs add-operations — バッチジョブに操作を追加します。
• google-ads-pp-cli customers-batch-jobs list-results — バッチジョブの結果を返します。ジョブが完了している必要があります。標準的なリストページネーションに対応しています。
• google-ads-pp-cli customers-batch-jobs mutate — バッチジョブを変更します。
• google-ads-pp-cli customers-batch-jobs run — バッチジョブを実行します。Operation.metadata フィールドの型は BatchJobMetadata です。完了すると、長時間実行される操作は...

customers_bidding_data_exclusions — Google Ads の顧客の入札データ除外操作

• google-ads-pp-cli customers-bidding-data-exclusions <customerId> — データ除外を作成、更新、または削除します。操作のステータスが返されます。

customers_bidding_seasonality_adjustments — Google Ads の顧客の入札季節性調整操作

• google-ads-pp-cli customers-bidding-seasonality-adjustments <customerId> — 季節性調整を作成、更新、または削除します。操作のステータスが返されます。

customers_bidding_strategies — Google Ads の顧客の入札戦略操作

• google-ads-pp-cli customers-bidding-strategies <customerId> — 入札戦略を作成、更新、または削除します。操作のステータスが返されます。

customers_billing_setups — Google Ads の顧客の請求設定操作

• google-ads-pp-cli customers-billing-setups <customerId> — 請求設定を作成するか、既存の請求設定をキャンセルします。

customers_campaign_asset_sets — Google Ads の顧客のキャンペーンアセットセット操作

• google-ads-pp-cli customers-campaign-asset-sets <customerId> — キャンペーンアセットセットを作成、更新、または削除します。操作のステータスが返されます。

customers_campaign_assets — Google Ads の顧客のキャンペーンアセット操作

• google-ads-pp-cli customers-campaign-assets <customerId> — キャンペーンアセットを作成、更新、または削除します。操作のステータスが返されます。

customers_campaign_bid_modifiers — Google Ads の顧客のキャンペーン入札単価調整操作

• google-ads-pp-cli customers-campaign-bid-modifiers <customerId> — キャンペーンの入札単価調整を作成、更新、または削除します。操作のステータスが返されます。 customers_campaign_budgets — Google Ads の顧客キャンペーン予算の操作

• google-ads-pp-cli customers-campaign-budgets <customerId> — キャンペーン予算を作成、更新、または削除します。操作のステータスが返されます。

customers_campaign_conversion_goals — Google Ads の顧客キャンペーンコンバージョン目標の操作

• google-ads-pp-cli customers-campaign-conversion-goals <customerId> — キャンペーンコンバージョン目標を作成、更新、または削除します。操作のステータスが返されます。

customers_campaign_criteria — Google Ads の顧客キャンペーン条件の操作

• google-ads-pp-cli customers-campaign-criteria <customerId> — 条件を作成、更新、または削除します。操作のステータスが返されます。

customers_campaign_customizers — Google Ads の顧客キャンペーンカスタマイザーの操作

• google-ads-pp-cli customers-campaign-customizers <customerId> — キャンペーンカスタマイザーを作成、更新、または削除します。操作のステータスが返されます。

customers_campaign_drafts — Google Ads の顧客キャンペーンドラフトの操作

• google-ads-pp-cli customers-campaign-drafts list-async-errors — CampaignDraft の適用中に発生したすべてのエラーを返します。キャンペーンドラフトがまだ適用されていない状態で呼び出すと、エラーが発生します。
• google-ads-pp-cli customers-campaign-drafts mutate — キャンペーンドラフトを作成、更新、または削除します。操作のステータスが返されます。
• google-ads-pp-cli customers-campaign-drafts promote — ドラフトの変更をベースキャンペーンに反映します。このメソッドは Long Running Operation（LRO）を返します。

customers_campaign_goal_configs — Google Ads の顧客キャンペーン目標設定の操作

• google-ads-pp-cli customers-campaign-goal-configs <customerId> — キャンペーン目標設定を作成または更新します。

customers_campaign_groups — Google Ads の顧客キャンペーングループの操作

• google-ads-pp-cli customers-campaign-groups <customerId> — キャンペーングループを作成、更新、または削除します。操作のステータスが返されます。

customers_campaign_labels — Google Ads の顧客キャンペーンラベルの操作

• google-ads-pp-cli customers-campaign-labels <customerId> — キャンペーンとラベルの関連付けを作成および削除します。操作のステータスが返されます。

customers_campaign_lifecycle_goal — Google Ads の顧客キャンペーンライフサイクル目標の操作

• google-ads-pp-cli customers-campaign-lifecycle-goal <customerId> — 指定されたキャンペーンライフサイクル設定を処理します。

customers_campaign_shared_sets — Google Ads の顧客キャンペーン共有セットの操作

• google-ads-pp-cli customers-campaign-shared-sets <customerId> — キャンペーン共有セットを作成または削除します。操作のステータスが返されます。

customers_campaigns — Google Ads の顧客キャンペーンの操作

• google-ads-pp-cli customers-campaigns enable-pmax-brand-guidelines — Performance Max キャンペーンのブランドガイドラインを有効にします。
• google-ads-pp-cli customers-campaigns mutate — キャンペーンを作成、更新、または削除します。操作のステータスが返されます。

customers_conversion_actions — Google Ads の顧客コンバージョンアクションの操作

• google-ads-pp-cli customers-conversion-actions <customerId> — コンバージョンアクションを作成、更新、または削除します。操作のステータスが返されます。

customers_conversion_custom_variables — Google Ads の顧客コンバージョンカスタム変数の操作

• google-ads-pp-cli customers-conversion-custom-variables <customerId> — コンバージョンカスタム変数を作成または更新します。操作のステータスが返されます。

customers_conversion_goal_campaign_configs — Google Ads の顧客コンバージョン目標キャンペーン設定の操作

• google-ads-pp-cli customers-conversion-goal-campaign-configs <customerId> — コンバージョン目標キャンペーン設定を作成、更新、または削除します。操作のステータスが返されます。

customers_conversion_value_rule_sets — Google Ads の顧客コンバージョン値ルールセットの操作

• google-ads-pp-cli customers-conversion-value-rule-sets <customerId> — コンバージョン値ルールセットを作成、更新、または削除します。操作ステータスが返されます。

customers_conversion_value_rules — Google Ads のお客様のコンバージョン値ルール操作

• google-ads-pp-cli customers-conversion-value-rules <customerId> — コンバージョン値ルールを作成、更新、または削除します。操作ステータスが返されます。

customers_custom_audiences — Google Ads のお客様のカスタムオーディエンス操作

• google-ads-pp-cli customers-custom-audiences <customerId> — カスタムオーディエンスを作成または更新します。操作ステータスが返されます。

customers_custom_conversion_goals — Google Ads のお客様のカスタムコンバージョンゴール操作

• google-ads-pp-cli customers-custom-conversion-goals <customerId> — カスタムコンバージョンゴールを作成、更新、または削除します。操作ステータスが返されます。

customers_custom_interests — Google Ads のお客様のカスタムインタレスト操作

• google-ads-pp-cli customers-custom-interests <customerId> — カスタムインタレストを作成または更新します。操作ステータスが返されます。

customers_customer_asset_sets — Google Ads のお客様の顧客アセットセット操作

• google-ads-pp-cli customers-customer-asset-sets <customerId> — 顧客アセットセットを作成、または削除します。操作ステータスが返されます。

customers_customer_assets — Google Ads のお客様の顧客アセット操作

• google-ads-pp-cli customers-customer-assets <customerId> — 顧客アセットを作成、更新、または削除します。操作ステータスが返されます。

customers_customer_client_links — Google Ads のお客様の顧客クライアントリンク操作

• google-ads-pp-cli customers-customer-client-links <customerId> — 顧客クライアントリンクを作成または更新します。操作ステータスが返されます。

customers_customer_conversion_goals — Google Ads のお客様の顧客コンバージョンゴール操作

• google-ads-pp-cli customers-customer-conversion-goals <customerId> — 顧客コンバージョンゴールを作成、更新、または削除します。操作ステータスが返されます。

customers_customer_customizers — Google Ads のお客様の顧客カスタマイザー操作

• google-ads-pp-cli customers-customer-customizers <customerId> — 顧客カスタマイザーを作成、更新、または削除します。操作ステータスが返されます。

customers_customer_labels — Google Ads のお客様の顧客ラベル操作

• google-ads-pp-cli customers-customer-labels <customerId> — 顧客ラベルの関連付けを作成および削除します。操作ステータスが返されます。

customers_customer_lifecycle_goal — Google Ads のお客様の顧客ライフサイクルゴール操作

• google-ads-pp-cli customers-customer-lifecycle-goal <customerId> — 指定された顧客ライフサイクル設定を処理します。

customers_customer_manager_links — Google Ads のお客様の顧客マネージャーリンク操作

• google-ads-pp-cli customers-customer-manager-links move-manager-link — クライアント顧客を新しいマネージャー顧客に移動します。これにより、2 つの操作を必要とする複雑なリクエストが簡素化されます...
• google-ads-pp-cli customers-customer-manager-links mutate — 顧客マネージャーリンクを更新します。操作ステータスが返されます。

customers_customer_negative_criteria — Google Ads のお客様の顧客除外条件操作

• google-ads-pp-cli customers-customer-negative-criteria <customerId> — 条件を作成または削除します。操作ステータスが返されます。

customers_customer_sk_ad_network_conversion_value_schemas — Google Ads のお客様の顧客 SK AdNetwork コンバージョン値スキーマ操作

• google-ads-pp-cli customers-customer-sk-ad-network-conversion-value-schemas <customerId> — CustomerSkAdNetworkConversionValueSchema を作成または更新します。

customers_customer_user_access_invitations — Google Ads のお客様の顧客ユーザーアクセス招待操作

• google-ads-pp-cli customers-customer-user-access-invitations <customerId> — アクセス招待を作成または削除します。 customers_customer_user_accesses — Google Ads の顧客ユーザーアクセス操作

• google-ads-pp-cli customers-customer-user-accesses <customerId> — 指定した顧客に対するユーザーの権限を更新または削除します。操作ステータスが返されます。

customers_customizer_attributes — Google Ads の顧客カスタマイザー属性操作

• google-ads-pp-cli customers-customizer-attributes <customerId> — カスタマイザー属性を作成、更新、または削除します。操作ステータスが返されます。

customers_data_links — Google Ads の顧客データリンク操作

• google-ads-pp-cli customers-data-links create — データリンクを作成します。リクエスト元の Google Ads アカウント名とアカウント ID は、サードパーティと共有されます（以下...
• google-ads-pp-cli customers-data-links remove — データリンクを削除します。
• google-ads-pp-cli customers-data-links update — データリンクを更新します。

customers_experiment_arms — Google Ads の顧客実験アーム操作

• google-ads-pp-cli customers-experiment-arms <customerId> — 実験アームを作成、更新、または削除します。操作ステータスが返されます。

customers_experiments — Google Ads の顧客実験操作

• google-ads-pp-cli customers-experiments end-experiment — 実験を直ちに終了し、実験の予定終了日を変更します。日付が変わるまで待つ必要はありません。終了...
• google-ads-pp-cli customers-experiments graduate-experiment — 実験を完全なキャンペーンに昇格させます。
• google-ads-pp-cli customers-experiments list-experiment-async-errors — 直近の実験更新（スケジュール設定または昇格）中に発生したすべてのエラーを返します。対応...
• google-ads-pp-cli customers-experiments mutate — 実験を作成、更新、または削除します。操作ステータスが返されます。
• google-ads-pp-cli customers-experiments promote-experiment — 試験キャンペーンを昇格させ、試験キャンペーンの変更をベースキャンペーンに適用します。このメソッドは...
• google-ads-pp-cli customers-experiments schedule-experiment — 実験をスケジュールします。設計中のキャンペーンは実際のキャンペーン（実験と呼ばれます）に変換されます...

customers_goals — Google Ads の顧客目標操作

• google-ads-pp-cli customers-goals <customerId> — 目標を作成または更新します。

customers-google-ads — Google Ads の顧客 Google Ads 操作

• google-ads-pp-cli customers-google-ads mutate — リソースを作成、更新、または削除します。このメソッドは、複数の種類のリソースを含むアトミックトランザクションに対応しています...
• google-ads-pp-cli customers-google-ads search — 検索クエリに一致するすべての行を返します。
• google-ads-pp-cli customers-google-ads search-stream — 検索ストリームクエリに一致するすべての行を返します。

customers_invoices — Google Ads の顧客請求書操作

• google-ads-pp-cli customers-invoices <customerId> — 指定した月の、請求設定に関連付けられたすべての請求書を返します。

customers_keyword_plan_ad_group_keywords — Google Ads の顧客キーワードプラン広告グループのキーワード操作

• google-ads-pp-cli customers-keyword-plan-ad-group-keywords <customerId> — キーワードプランの広告グループキーワードを作成、更新、または削除します。操作ステータスが返されます。

customers_keyword_plan_ad_groups — Google Ads の顧客キーワードプラン広告グループ操作

• google-ads-pp-cli customers-keyword-plan-ad-groups <customerId> — キーワードプランの広告グループを作成、更新、または削除します。操作ステータスが返されます。

customers_keyword_plan_campaign_keywords — Google Ads の顧客キーワードプランキャンペーンのキーワード操作

• google-ads-pp-cli customers-keyword-plan-campaign-keywords <customerId> — キーワードプランのキャンペーンキーワードを作成、更新、または削除します。操作ステータスが返されます。

customers_keyword_plan_campaigns — Google Ads の顧客キーワードプランキャンペーン操作

• google-ads-pp-cli customers-keyword-plan-campaigns <customerId> — キーワードプランのキャンペーンを作成、更新、または削除します。操作のステータスが返されます。

customers_keyword_plans — Google Ads の顧客のキーワードプラン操作

• google-ads-pp-cli customers-keyword-plans <customerId> — キーワードプランを作成、更新、または削除します。操作のステータスが返されます。

customers_labels — Google Ads の顧客のラベル操作

• google-ads-pp-cli customers-labels <customerId> — ラベルを作成、更新、または削除します。操作のステータスが返されます。

customers_local_services — Google Ads の顧客のローカルサービス操作

• google-ads-pp-cli customers-local-services <customerId> — Local Services Lead リソースに Local Services Lead Conversation リソースを追加する RPC です。

customers_local_services_leads — Google Ads の顧客のローカルサービスリード操作

• google-ads-pp-cli customers-local-services-leads <resourceName> — Local Services Lead リソースに関するフィードバックを提供する RPC です。

customers_offline_user_data_jobs — Google Ads の顧客のオフラインユーザーデータジョブ操作

• google-ads-pp-cli customers-offline-user-data-jobs add-operations — オフラインユーザーデータジョブに操作を追加します。
• google-ads-pp-cli customers-offline-user-data-jobs create — オフラインユーザーデータジョブを作成します。
• google-ads-pp-cli customers-offline-user-data-jobs run — オフラインユーザーデータジョブを実行します。完了すると、長時間実行オペレーションに処理結果が含まれます。または...

customers_operations — Google Ads の顧客のオペレーション操作

• google-ads-pp-cli customers-operations cancel — 長時間実行オペレーションの非同期キャンセルを開始します。サーバーはキャンセルに最善を尽くします...
• google-ads-pp-cli customers-operations delete — 長時間実行オペレーションを削除します。このメソッドは、クライアントがそのオペレーションに関心がなくなったことを示します...
• google-ads-pp-cli customers-operations get — 長時間実行オペレーションの最新の状態を取得します。クライアントはこのメソッドを使用して、オペレーションの結果をポーリングできます...
• google-ads-pp-cli customers-operations list — リクエストで指定されたフィルターに一致するオペレーションを一覧表示します。サーバーがこのメソッドをサポートしていない場合は...
• google-ads-pp-cli customers-operations wait — 指定された長時間実行オペレーションが完了するか、指定されたタイムアウトに達するまで待機し、結果を返します...

customers_payments_accounts — Google Ads の顧客の支払いアカウント操作

• google-ads-pp-cli customers-payments-accounts <customerId> — ログイン顧客 ID と指定された配信アカウントの間にあるすべてのマネージャーに関連付けられた、すべての支払いアカウントを返します...

customers_product_link_invitations — Google Ads の顧客の商品リンク招待操作

• google-ads-pp-cli customers-product-link-invitations create — 商品リンクの招待を作成します。
• google-ads-pp-cli customers-product-link-invitations remove — 商品リンクの招待を削除します。
• google-ads-pp-cli customers-product-link-invitations update — 商品リンクの招待を更新します。

customers_product_links — Google Ads の顧客の商品リンク操作

• google-ads-pp-cli customers-product-links create — 商品リンクを作成します。
• google-ads-pp-cli customers-product-links remove — 商品リンクを削除します。

customers_recommendation_subscriptions — Google Ads の顧客のレコメンデーション登録操作

• google-ads-pp-cli customers-recommendation-subscriptions <customerId> — 対応する適用パラメーターを使用して、指定された登録情報を変更します。

customers_recommendations — Google Ads の顧客のレコメンデーション操作

• google-ads-pp-cli customers-recommendations apply — 対応する適用パラメーターを使用して、指定されたレコメンデーションを適用します。

• google-ads-pp-cli customers-recommendations dismiss — 指定されたレコメンデーションを非表示にします。

• google-ads-pp-cli customers-recommendations generate — リクエストされた recommendation_types に基づいてレコメンデーションを生成します。 customers_remarketing_actions — Google Ads の顧客リマーケティング アクション操作

• google-ads-pp-cli customers-remarketing-actions <customerId> — リマーケティング アクションを作成または更新します。操作のステータスが返されます。

customers_shared_criteria — Google Ads の顧客共有条件操作

• google-ads-pp-cli customers-shared-criteria <customerId> — 共有条件を作成または削除します。操作のステータスが返されます。

customers_shared_sets — Google Ads の顧客共有セット操作

• google-ads-pp-cli customers-shared-sets <customerId> — 共有セットを作成、更新、または削除します。操作のステータスが返されます。

customers_smart_campaign_settings — Google Ads の顧客スマートキャンペーン設定操作

• google-ads-pp-cli customers-smart-campaign-settings get-smart-campaign-status — 要求されたスマートキャンペーンのステータスを返します。
• google-ads-pp-cli customers-smart-campaign-settings mutate — キャンペーンのスマートキャンペーン設定を更新します。

customers_third_party_app_analytics_links — Google Ads の顧客サードパーティアプリ分析リンク操作

• google-ads-pp-cli customers-third-party-app-analytics-links <resourceName> — ThirdPartyAppAnalyticsLink.shareable_link_id を再生成します。これは、設定時にサードパーティに提供する必要があります...

customers_user_list_customer_types — Google Ads の顧客ユーザーリスト顧客タイプ操作

• google-ads-pp-cli customers-user-list-customer-types <customerId> — ユーザーリストの顧客タイプを関連付けるか削除します。操作のステータスが返されます。

customers_user_lists — Google Ads の顧客ユーザーリスト操作

• google-ads-pp-cli customers-user-lists <customerId> — ユーザーリストを作成または更新します。操作のステータスが返されます。

geo_target_constants — Google Ads の地域ターゲット定数操作

• google-ads-pp-cli geo-target-constants — 地域名またはリソース名に基づいて GeoTargetConstant の候補を返します。

google_ads — Google Ads の Google Ads 操作

• google-ads-pp-cli google-ads generate-conversion-rates — 対応するプランニング可能な商品について、コンバージョン率の候補一覧を返します。
• google-ads-pp-cli google-ads list-plannable-locations — プランニング可能な地域（国など）の一覧を返します。
• google-ads-pp-cli google-ads list-plannable-products — 地域ごとにプランニング可能な YouTube 広告フォーマットと、許可されているターゲティングの一覧を返します。
• google-ads-pp-cli google-ads list-plannable-user-interests — プランニング可能なユーザー インタレストの一覧を返します。プランニング可能なユーザー インタレストとは、リーチでターゲティングできるものです...
• google-ads-pp-cli google-ads list-plannable-user-lists — プランニング可能なユーザーリストと、そのプランニング可能ステータスの一覧を返します。ユーザーリストは、さまざまな理由でプランニングできない場合があります...

google_ads_fields — Google Ads の Google Ads フィールド操作

• google-ads-pp-cli google-ads-fields get — 要求されたフィールドのみを返します。
• google-ads-pp-cli google-ads-fields search — 検索クエリに一致するすべてのフィールドを返します。

keyword_theme_constants — Google Ads のキーワードテーマ定数操作

• google-ads-pp-cli keyword-theme-constants — キーワードテーマに基づいて KeywordThemeConstant の候補を返します。

適切なコマンドを見つける

実行したいことは分かっていても、どのコマンドを使えばよいか分からない場合は、CLI に直接尋ねてください。

google-ads-pp-cli which "<capability in your own words>"

which は、自然言語で記述された機能の問い合わせを、この CLI の厳選された機能インデックスから最適なコマンドに対応付けます。終了コード 0 は少なくとも 1 件の一致があることを示し、終了コード 2 は確実な一致がないことを示します。その場合は --help を使うか、より具体的な問い合わせに切り替えてください。

認証の設定

OAuth2 フローで認証します。auth login を実行するとブラウザーが開き、同意フローが実行され、リフレッシュトークンが保存されるため、アクセストークンが自動的に発行されます。

google-ads-pp-cli auth login --client-id YOUR_CLIENT_ID --client-secret YOUR_CLIENT_SECRET

--client-id / --client-secret は、設定されている場合、デフォルトで $GOOGLE_ADS_CLIENT_ID / $GOOGLE_ADS_CLIENT_SECRET を使用します。保存済みの認可を確認または削除するには、google-ads-pp-cli auth status と google-ads-pp-cli auth logout を実行します。

また、GOOGLE_ADS_DEVELOPER_TOKEN を設定してください。マネージャーアカウント経由で呼び出す場合は、GOOGLE_ADS_LOGIN_CUSTOMER_ID も設定します。

google-ads-pp-cli doctor を実行して設定を確認してください。

エージェントモード

任意のコマンドに --agent を追加します。次のオプションに展開されます：--json --compact --no-input --no-color --yes。

• パイプ可能 — 標準出力には JSON、標準エラー出力にはエラーが出力されます

• フィルタ可能 — --select でフィールドを絞り込めます。ドット区切りのパスはネストされた構造に進み、配列では各要素をたどります。詳細な API でコンテキストを小さく保つために重要です。

  google-ads-pp-cli customers-google-ads search mock-value --agent --select id,name,status
  

• プレビュー可能 — --dry-run を指定すると、送信せずにリクエストを表示します

• オフラインでも利用可能 — 同期／検索コマンドでは、利用可能な場合にローカルの SQLite ストアを使用できます

• 非対話型 — プロンプトは表示されず、すべての入力はフラグで指定します

• 再試行を明示 — すでに存在するものの作成を成功として扱う場合に限り --idempotent を使用し、削除対象が存在しないことを成功として扱う場合に限り --ignore-missing を使用します

レスポンスエンベロープ

ローカルストアまたは API から読み取るコマンドは、出力をデータの出所を示すエンベロープでラップします。

{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

データには .results を解析し、ライブデータかローカルデータかを確認するには .meta.source を参照してください。人が読める N results (live) の要約は、標準出力が端末の場合にのみ標準エラー出力へ表示されます。パイプやエージェントの利用者には、標準出力に純粋な JSON のみが出力されます。

エージェントからのフィードバック

この CLI で気になる点に気付いた場合（エージェントが気付いた場合も含む）、記録してください。

google-ads-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
google-ads-pp-cli feedback --stdin < notes.txt
google-ads-pp-cli feedback list --json --limit 10

エントリーは ~/.google-ads-pp-cli/feedback.jsonl にローカル保存されます。GOOGLE_ADS_FEEDBACK_ENDPOINT が設定されていて、かつ --send が指定されるか、GOOGLE_ADS_FEEDBACK_AUTO_SEND=true が設定されている場合を除き、POST されることはありません。デフォルトではローカルにのみ保存されます。

バグ報告ではなく、意外だったことを書いてください。短く、具体的に、1 行で。それが積み重なって役立ちます。

出力の送信先

すべてのコマンドで --deliver <sink> を指定できます。出力は標準出力に加えて、または標準出力の代わりに、指定した送信先にも出力されるため、エージェントはコマンド結果を手作業でパイプせずに振り分けられます。サポートされている送信先は 3 種類です。

送信先	動作
stdout	デフォルト。標準出力のみに書き込みます
file:<path>	出力を <path> にアトミックに書き込みます（一時ファイル＋リネーム）
webhook:<url>	出力本文を URL に POST します（--compact の場合は application/json または application/x-ndjson）

不明なスキームは、サポート対象の一覧を示す構造化エラーとともに拒否されます。Webhook が失敗すると、ゼロ以外の終了コードが返され、URL と HTTP ステータスが標準エラー出力に記録されます。

名前付きプロファイル

プロファイルは、保存されたフラグ値のセットで、実行のたびに再利用できます。スケジュールされたエージェントが、同じ設定で同じコマンドを毎回呼び出す場合に使用します。これは HeyGen の「Beacon」パターンです。

google-ads-pp-cli profile save briefing --json
google-ads-pp-cli --profile briefing customers-google-ads search mock-value
google-ads-pp-cli profile list --json
google-ads-pp-cli profile show briefing
google-ads-pp-cli profile delete briefing --yes

明示的に指定したフラグは常にプロファイル値より優先され、プロファイル値はデフォルト値より優先されます。agent-context は、利用可能なすべてのプロファイルを available_profiles に一覧表示するため、情報を調べるエージェントは実行時にプロファイルを検出できます。

非同期ジョブ

長時間実行される処理を送信するエンドポイントでは、ジェネレーターが送信後にポーリングするパターン（レスポンスに job_id／task_id／operation_id フィールドがあり、対応するステータスエンドポイントがある場合）を検出し、送信コマンドに 3 つの追加フラグを設定します。

フラグ	用途
--wait	ジョブ ID をすぐに返す代わりに、ジョブが終端ステータスに達するまで待機します
--wait-timeout	最大待機時間（デフォルトは 10m、0 はタイムアウトなし）
--wait-interval	初回のポーリング間隔（デフォルトは 2s。指数バックオフで最大 30s まで延長されます）

処理を開始して結果を待たない場合は、--wait を指定せずに非同期送信を使用します。完了した成果物を 1 つのコマンドで返したい場合は、--wait を使用します。

終了コード

コード	意味
0	成功
2	使用方法エラー（引数が間違っています）
3	リソースが見つかりません
4	認証が必要です
5	API エラー（上流の問題）
7	レート制限中（待ってから再試行してください）
10	設定エラー

引数の解析

$ARGUMENTS を解析します。

1. 空、help、または --help → google-ads-pp-cli --help の出力を表示します
2. install で始まる → mcp で終わる場合は MCP のインストール、それ以外の場合は上記の前提条件を参照してください
3. それ以外 → 直接使用（--agent を指定して CLI コマンドとして実行します）

MCP サーバーのインストール

1. MCP サーバーをインストールします。

   go install github.com/mvanhorn/printing-press-library/library/marketing/google-ads/cmd/google-ads-pp-mcp@latest
   

2. Claude Code に登録します。

   claude mcp add google-ads-pp-mcp -- google-ads-pp-mcp
   

3. 確認します：claude mcp list

直接使用

1. インストールされているか確認します：which google-ads-pp-cli 見つからない場合は、インストールを提案してください（このスキルの冒頭にある前提条件を参照してください）。
2. ユーザーの問い合わせに最適なコマンドを、上記の独自機能とコマンドリファレンスから選びます。
3. --agent フラグを指定して実行します。

   google-ads-pp-cli <command> [subcommand] [args] --agent
   

4. 曖昧な場合は、サブコマンドのヘルプを確認します：google-ads-pp-cli <command> --help。