Caution: You are viewing documentation for the API's REST interface. Most of our official client libraries use gRPC. See the REST Introduction for details.

Google Ads API

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

この API を使用して Google 広告アカウント、キャンペーン、レポートを管理します。

サービス: googleads.googleapis.com

サービス エンドポイント

サービス エンドポイントは、API サービスのネットワーク アドレスを指定するベース URL です。1 つのサービスに複数のサービス エンドポイントが存在することもあります。このサービスには次のサービス エンドポイントがあり、以下のすべての URI がこのサービス エンドポイントに関連しています。

  • https://googleads.googleapis.com

REST リソース: v11

Methods
listPlannableLocations POST /v11:listPlannableLocations
計画可能な場所(国など)のリストを返します。
listPlannableProducts POST /v11:listPlannableProducts
許可されたターゲティングで、地域ごとのプランニング可能な YouTube 広告フォーマットのリストを返します。

REST リソース: v11.customers

Methods
createCustomerClient POST /v11/customers/{customerId}:createCustomerClient
マネージャーの下に新しいクライアントを作成します。
generateAdGroupThemes POST /v11/customers/{customerId}:generateAdGroupThemes
指定されたキーワードに対して広告グループと提案された変更(テキスト、マッチタイプ)のリストを返します。
generateInsightsFinderReport POST /v11/customers/{customerId}:generateInsightsFinderReport
保存済みレポートを作成し、Insights Finder ツールで表示できます。
generateKeywordHistoricalMetrics POST /v11/customers/{customerId}:generateKeywordHistoricalMetrics
キーワードの過去の指標のリストを返します。
generateKeywordIdeas POST /v11/customers/{customerId}:generateKeywordIdeas
キーワード候補のリストを返します。
generateProductMixIdeas POST /v11/customers/{customerId}:generateProductMixIdeas
一連の指定をもとにプロダクト構成のアイデアを生成します。
generateReachForecast POST /v11/customers/{customerId}:generateReachForecast
特定のターゲティング / 商品構成のリーチ予測を生成します。
listAccessibleCustomers GET /v11/customers:listAccessibleCustomers
通話の認証を行ったユーザーが直接アクセスできる顧客のリソース名を返します。
mutate POST /v11/customers/{customerId}:mutate
顧客を更新します。
searchAudienceInsightsAttributes POST /v11/customers/{customerId}:searchAudienceInsightsAttributes
分析情報の生成に使用できるオーディエンス属性を検索します。
suggestKeywordThemes POST /v11/customers/{customerId}:suggestKeywordThemes
広告を表示するキーワードのテーマを提案します。
suggestSmartCampaignAd POST /v11/customers/{customerId}:suggestSmartCampaignAd
ターゲティングや宣伝するビジネスなどのデータポイントに基づいて、広告ファミリーのリソースに対応したスマート キャンペーン広告を提案します。
suggestSmartCampaignBudgetOptions POST /v11/customers/{customerId}:suggestSmartCampaignBudgetOptions
BudgetOption の提案を返します。
uploadCallConversions POST /v11/customers/{customerId}:uploadCallConversions
指定された通話コンバージョンを処理します。
uploadClickConversions POST /v11/customers/{customerId}:uploadClickConversions
指定されたクリック コンバージョンを処理します。
uploadConversionAdjustments POST /v11/customers/{customerId}:uploadConversionAdjustments
指定されたコンバージョンの調整を処理します。
uploadUserData POST /v11/customers/{customerId}:uploadUserData
指定されたユーザーデータをアップロードします。

REST リソース: v11.customers.VelostrataCustomizers

Methods
mutate POST /v11/customers/{customerId}/AdGroupCriterionCustomizers:mutate
広告グループの条件カスタマイザを作成、更新、削除します。

REST リソース: v11.customers.CustomerCustomizers

Methods
mutate POST /v11/customers/{customerId}/CustomerCustomizers:mutate
顧客カスタマイザを作成、更新、削除します。

REST リソース: v11.customers.accountBudgetProposals

Methods
mutate POST /v11/customers/{customerId}/accountBudgetProposals:mutate
アカウントの予算の提案を作成、更新、削除します。

REST リソース: v11.customers.adGroupAdLabels

Methods
mutate POST /v11/customers/{customerId}/adGroupAdLabels:mutate
広告グループの広告ラベルを作成して削除します。

REST リソース: v11.customers.adGroupAds

Methods
mutate POST /v11/customers/{customerId}/adGroupAds:mutate
広告の作成、更新、削除。

REST リソース: v11.customers.adGroupAssets

Methods
mutate POST /v11/customers/{customerId}/adGroupAssets:mutate
広告グループ アセットの作成、更新、削除を行います。

REST リソース: v11.customers.adGroupBidModifiers

Methods
mutate POST /v11/customers/{customerId}/adGroupBidModifiers:mutate
広告グループの入札単価調整比を作成、更新、削除します。

REST リソース: v11.customers.adGroupCriteria

Methods
mutate POST /v11/customers/{customerId}/adGroupCriteria:mutate
条件を作成、更新、または削除します。

REST リソース: v11.customers.adGroupCriteriaLabels

Methods
mutate POST /v11/customers/{customerId}/adGroupCriterionLabels:mutate
広告グループの条件ラベルを作成して削除します。

REST リソース: v11.customers.adGroupCustomizers

Methods
mutate POST /v11/customers/{customerId}/adGroupCustomizers:mutate
広告グループカスタマイザを作成、更新、削除します。

REST リソース: v11.customers.adGroupExtensionSettings

Methods
mutate POST /v11/customers/{customerId}/adGroupExtensionSettings:mutate
広告グループの広告表示オプションの設定を作成、更新、削除します。

REST リソース: v11.customers.adGroupFeeds

Methods
mutate POST /v11/customers/{customerId}/adGroupFeeds:mutate
広告グループ フィードを作成、更新、削除します。

REST リソース: v11.customers.adGroupLabels

Methods
mutate POST /v11/customers/{customerId}/adGroupLabels:mutate
広告グループのラベルを作成、削除します。

REST リソース: v11.customers.adGroups

Methods
mutate POST /v11/customers/{customerId}/adGroups:mutate
広告グループを作成、更新、削除します。

REST リソース: v11.customers.adParameters

Methods
mutate POST /v11/customers/{customerId}/adParameters:mutate
広告パラメータの作成、更新、削除を行います。

REST リソース: v11.customers.ads

Methods
get GET /v11/{resourceName=customers/*/ads/*}
リクエストされた広告の詳細を返します。
mutate POST /v11/customers/{customerId}/ads:mutate
広告を更新します。

REST リソース: v11.customers.assetGroupAssets

Methods
mutate POST /v11/customers/{customerId}/assetGroupAssets:mutate
アセット グループのアセットを作成、更新、削除します。

REST リソース: v11.customers.assetGroupListingGroupFilters

Methods
mutate POST /v11/customers/{customerId}/assetGroupListingGroupFilters:mutate
アセット グループ リスティング グループのフィルタを作成、更新、削除します。

REST リソース: v11.customers.assetGroupSignals

Methods
mutate POST /v11/customers/{customerId}/assetGroupSignals:mutate
アセット グループのシグナルを追加または削除します。

REST リソース: v11.customers.assetGroups

Methods
mutate POST /v11/customers/{customerId}/assetGroups:mutate
アセット グループを作成、更新、削除します。

REST リソース: v11.customers.assetSetAssets

Methods
mutate POST /v11/customers/{customerId}/assetSetAssets:mutate
アセットセット アセットの作成、更新、削除。

REST リソース: v11.customers.assetSets

Methods
mutate POST /v11/customers/{customerId}/assetSets:mutate
アセットセットの作成、更新、削除を行います。

REST リソース: v11.customers.assets

Methods
mutate POST /v11/customers/{customerId}/assets:mutate
アセットを作成します。

REST リソース: v11.customers.audiences

Methods
mutate POST /v11/customers/{customerId}/audiences:mutate
オーディエンスを作成します。

REST リソース: v11.customers.batchJobs

Methods
addOperations POST /v11/{resourceName=customers/*/batchJobs/*}:addOperations
バッチジョブにオペレーションを追加します。
listResults GET /v11/{resourceName=customers/*/batchJobs/*}:listResults
バッチジョブの結果を返します。
mutate POST /v11/customers/{customerId}/batchJobs:mutate
バッチジョブを変更します。
run POST /v11/{resourceName=customers/*/batchJobs/*}:run
バッチジョブを実行します。

REST リソース: v11.customers.biddingDataExclusions

Methods
mutate POST /v11/customers/{customerId}/biddingDataExclusions:mutate
データの除外を作成、更新、削除します。

REST リソース: v11.customers.biddingSeasonalityAdjustments

Methods
mutate POST /v11/customers/{customerId}/biddingSeasonalityAdjustments:mutate
季節性の調整を作成、更新、削除します。

REST リソース: v11.customers.biddingStrategies

Methods
mutate POST /v11/customers/{customerId}/biddingStrategies:mutate
入札戦略を作成、更新、削除します。

REST リソース: v11.customers.billingSetups

Methods
mutate POST /v11/customers/{customerId}/billingSetups:mutate
お支払い情報の設定を作成するか、既存のお支払い情報をキャンセルします。

REST リソース: v11.customers.campaignAssetSets

Methods
mutate POST /v11/customers/{customerId}/campaignAssetSets:mutate
キャンペーン アセットセットの作成、更新、削除。

REST リソース: v11.customers.campaignAssets

Methods
mutate POST /v11/customers/{customerId}/campaignAssets:mutate
キャンペーン アセットの作成、更新、削除。

REST リソース: v11.customers.campaignBidModifiers

Methods
mutate POST /v11/customers/{customerId}/campaignBidModifiers:mutate
キャンペーンの入札単価調整比を作成、更新、削除します。

REST リソース: v11.customers.campaignBudgets

Methods
mutate POST /v11/customers/{customerId}/campaignBudgets:mutate
キャンペーン予算を作成、更新、削除します。

REST リソース: v11.customers.campaignConversionGoals

Methods
mutate POST /v11/customers/{customerId}/campaignConversionGoals:mutate
キャンペーンのコンバージョン目標を作成、更新、または削除します。

REST リソース: v11.customers.campaignCriteria

Methods
mutate POST /v11/customers/{customerId}/campaignCriteria:mutate
条件を作成、更新、または削除します。

REST リソース: v11.customers.campaignCustomizers

Methods
mutate POST /v11/customers/{customerId}/campaignCustomizers:mutate
キャンペーンカスタマイザを作成、更新、または削除します。

REST リソース: v11.customers.campaignDrafts

Methods
listAsyncErrors GET /v11/{resourceName=customers/*/campaignDrafts/*}:listAsyncErrors
CampaignDraft のプロモーション中に発生したすべてのエラーを返します。
mutate POST /v11/customers/{customerId}/campaignDrafts:mutate
キャンペーンの下書きを作成、更新、削除します。
promote POST /v11/{campaignDraft=customers/*/campaignDrafts/*}:promote
下書きの変更を基本のキャンペーンに反映させます。

REST リソース: v11.customers.campaignExperiments

Methods
create POST /v11/customers/{customerId}/campaignExperiments:create
キャンペーンの下書きに基づいてキャンペーン テストを作成します。
end POST /v11/{campaignExperiment=customers/*/campaignExperiments/*}:end
キャンペーン テストはすぐに終了し、テストの終了日が変わり、終了日まで待つ必要はありません。
graduate POST /v11/{campaignExperiment=customers/*/campaignExperiments/*}:graduate
キャンペーン テストはフルキャンペーンへと移行されます。
listAsyncErrors GET /v11/{resourceName=customers/*/campaignExperiments/*}:listAsyncErrors
CampaignExperiment の作成またはプロモーションで発生したすべてのエラー(最後に発生したもの)を返します。
mutate POST /v11/customers/{customerId}/campaignExperiments:mutate
キャンペーンのテストを更新します。
promote POST /v11/{campaignExperiment=customers/*/campaignExperiments/*}:promote
テスト キャンペーンの変更を基本のキャンペーンに戻します。

REST リソース: v11.customers.campaignExtensionSettings

Methods
mutate POST /v11/customers/{customerId}/campaignExtensionSettings:mutate
キャンペーン単位の広告表示オプションの設定を作成、更新、削除します。

REST リソース: v11.customers.campaignFeeds

Methods
mutate POST /v11/customers/{customerId}/campaignFeeds:mutate
キャンペーン フィードを作成、更新、削除します。

REST リソース: v11.customers.campaignGroups

Methods
mutate POST /v11/customers/{customerId}/campaignGroups:mutate
キャンペーン グループを作成、更新、削除します。

REST リソース: v11.customers.campaignLabels

Methods
mutate POST /v11/customers/{customerId}/campaignLabels:mutate
キャンペーン ラベル関係を作成、削除します。

REST リソース: v11.customers.campaignSharedSets

Methods
mutate POST /v11/customers/{customerId}/campaignSharedSets:mutate
キャンペーンの共有設定を作成または削除します。

REST リソース: v11.customers.campaigns

Methods
mutate POST /v11/customers/{customerId}/campaigns:mutate
キャンペーンを作成、更新、削除します。

REST リソース: v11.customers.conversionActions

Methods
mutate POST /v11/customers/{customerId}/conversionActions:mutate
コンバージョン アクションの作成、更新、削除。

REST リソース: v11.customers.conversionCustomVariables

Methods
mutate POST /v11/customers/{customerId}/conversionCustomVariables:mutate
コンバージョン カスタム変数を作成または更新します。

REST リソース: v11.customers.conversionGoalCampaignConfigs

Methods
mutate POST /v11/customers/{customerId}/conversionGoalCampaignConfigs:mutate
コンバージョン目標のキャンペーン設定を作成、更新、削除します。

REST リソース: v11.customers.conversionValueRuleSets

Methods
mutate POST /v11/customers/{customerId}/conversionValueRuleSets:mutate
コンバージョン値のルールセットを作成、更新、削除します。

REST リソース: v11.customers.conversionValueRules

Methods
mutate POST /v11/customers/{customerId}/conversionValueRules:mutate
コンバージョン値のルールを作成、更新、削除します。

REST リソース: v11.customers.customAudiences

Methods
mutate POST /v11/customers/{customerId}/customAudiences:mutate
カスタム オーディエンスを作成または更新します。

REST リソース: v11.customers.customConversionGoals

Methods
mutate POST /v11/customers/{customerId}/customConversionGoals:mutate
カスタム コンバージョン目標を作成、更新、または削除します。

REST リソース: v11.customers.customInterests

Methods
mutate POST /v11/customers/{customerId}/customInterests:mutate
カスタム インタレストを作成または更新します。

REST リソース: v11.customers.customerAssets

Methods
mutate POST /v11/customers/{customerId}/customerAssets:mutate
顧客アセットを作成、更新、削除します。

REST リソース: v11.customers.customerConversionGoals

Methods
mutate POST /v11/customers/{customerId}/customerConversionGoals:mutate
顧客のコンバージョン目標を作成、更新、または削除します。

REST リソース: v11.customers.customerExtensionSettings

Methods
mutate POST /v11/customers/{customerId}/customerExtensionSettings:mutate
顧客拡張機能の設定を作成、更新、削除します。

REST リソース: v11.customers.customerFeeds

Methods
mutate POST /v11/customers/{customerId}/customerFeeds:mutate
顧客フィードを作成、更新、削除します。

REST リソース: v11.customers.customerLabels

Methods
mutate POST /v11/customers/{customerId}/customerLabels:mutate
顧客ラベル関係を作成、削除します。

REST リソース: v11.customers.customerNegativeCriteria

Methods
mutate POST /v11/customers/{customerId}/customerNegativeCriteria:mutate
条件を作成または削除します。

REST リソース: v11.customers.customerUserAccessInvitations

Methods
mutate POST /v11/customers/{customerId}/customerUserAccessInvitations:mutate
アクセス招待を作成または削除します。

REST リソース: v11.customers.customerUserAccesses

Methods
mutate POST /v11/customers/{customerId}/customerUserAccesses:mutate
更新を行い、特定の顧客のユーザー権限を削除します。

REST リソース: v11.customers.CustomizerAttributes

Methods
mutate POST /v11/customers/{customerId}/customizerAttributes:mutate
カスタマイザの属性を作成、更新、または削除します。

REST リソース: v11.customers.experimentArms

Methods
mutate POST /v11/customers/{customerId}/experimentArms:mutate
テストアームを作成、更新、削除します。

REST リソース: v11.customers.experiments

Methods
endExperiment POST /v11/{experiment=customers/*/experiments/*}:endExperiment
テストは直ちに終了し、テストの終了日が変わり、終了日を待つことなく変更されます。
graduateExperiment POST /v11/{experiment=customers/*/experiments/*}:graduateExperiment
テストは完全なキャンペーンです。
listExperimentAsyncErrors GET /v11/{resourceName=customers/*/experiments/*}:listExperimentAsyncErrors
テストの最終更新(スケジュールまたはプロモーション)で発生したすべてのエラーが返されます。
mutate POST /v11/customers/{customerId}/experiments:mutate
テストを作成、更新、削除します。
promoteExperiment POST /v11/{resourceName=customers/*/experiments/*}:promoteExperiment
テスト キャンペーンをプロモートするため、テスト キャンペーンに加えた変更がベース キャンペーンに適用されます。
scheduleExperiment POST /v11/{resourceName=customers/*/experiments/*}:scheduleExperiment
テストのスケジュールを設定します。

REST リソース: v11.customers.extensionFeedItems

Methods
mutate POST /v11/customers/{customerId}/extensionFeedItems:mutate
広告表示オプションのフィード アイテムの作成、更新、削除を行います。

REST リソース: v11.customers.feedItemSets

Methods
mutate POST /v11/customers/{customerId}/feedItemSets:mutate
フィード アイテムセットの作成、更新、削除を行います。

REST リソース: v11.customers.feedItemTargets

Methods
mutate POST /v11/customers/{customerId}/feedItemTargets:mutate
フィード アイテムのターゲットを追加または削除します。

REST リソース: v11.customers.feedItems

Methods
mutate POST /v11/customers/{customerId}/feedItems:mutate
フィード アイテムの作成、更新、削除を行います。

REST リソース: v11.customers.feedMappings

Methods
mutate POST /v11/customers/{customerId}/feedMappings:mutate
フィード マッピングを作成または削除します。

REST リソース: v11.customers.feeds

Methods
mutate POST /v11/customers/{customerId}/feeds:mutate
フィードの作成、更新、削除。

REST リソース: v11.customers.googleAds

Methods
mutate POST /v11/customers/{customerId}/googleAds:mutate
リソースの作成、更新、削除。
search POST /v11/customers/{customerId}/googleAds:search
検索クエリに一致するすべての行を返します。
searchStream POST /v11/customers/{customerId}/googleAds:searchStream
検索ストリーム クエリに一致するすべての行を返します。

REST リソース: v11.customers.invoices

Methods
list GET /v11/customers/{customerId}/invoices
指定された月に関連付けられた請求設定に関連付けられているすべての請求書を返します。

REST リソース: v11.customers.keywordPlanAdGroupKeyword

Methods
mutate POST /v11/customers/{customerId}/keywordPlanAdGroupKeywords:mutate
キーワード プランの広告グループ キーワードを作成、更新、削除します。

REST リソース: v11.customers.keywordPlanAdGroups

Methods
mutate POST /v11/customers/{customerId}/keywordPlanAdGroups:mutate
キーワード プランの広告グループを作成、更新、削除します。

REST リソース: v11.customers.keywordPlanCampaignKeyword

Methods
mutate POST /v11/customers/{customerId}/keywordPlanCampaignKeywords:mutate
キーワード プランのキャンペーン キーワードを作成、更新、削除します。

REST リソース: v11.customers.keywordPlanCampaigns

Methods
mutate POST /v11/customers/{customerId}/keywordPlanCampaigns:mutate
キーワード プランのキャンペーンを作成、更新、削除します。

REST リソース: v11.customers.keywordPlans

Methods
generateForecastCurve POST /v11/{keywordPlan=customers/*/keywordPlans/*}:generateForecastCurve
リクエストされたキーワード プランの予測曲線を返します。
generateForecastMetrics POST /v11/{keywordPlan=customers/*/keywordPlans/*}:generateForecastMetrics
リクエストされたキーワード プランの予測を返します。
generateForecastTimeSeries POST /v11/{keywordPlan=customers/*/keywordPlans/*}:generateForecastTimeSeries
キーワード プランの 52 週間にわたる時系列の予測が表示されます。
generateHistoricalMetrics POST /v11/{keywordPlan=customers/*/keywordPlans/*}:generateHistoricalMetrics
リクエストされたキーワード プランの過去の指標を返します。
mutate POST /v11/customers/{customerId}/keywordPlans:mutate
キーワード プランの作成、更新、削除を行います。

REST リソース: v11.customers.labels

Methods
mutate POST /v11/customers/{customerId}/labels:mutate
ラベルを作成、更新、削除します。

REST リソース: v11.customers.mediaFiles

Methods
mutate POST /v11/customers/{customerId}/mediaFiles:mutate
メディア ファイルを作成します。

REST リソース: v11.customers.offlineUserDataJobs

Methods
addOperations POST /v11/{resourceName=customers/*/offlineUserDataJobs/*}:addOperations
オフライン ユーザーデータ ジョブにオペレーションを追加します。
create POST /v11/customers/{customerId}/offlineUserDataJobs:create
オフライン ユーザーデータ ジョブを作成します。
run POST /v11/{resourceName=customers/*/offlineUserDataJobs/*}:run
オフライン ユーザーデータ ジョブを実行します。

REST リソース: v11.customers.operations

Methods
cancel POST /v11/{name=customers/*/operations/*}:cancel
長時間実行オペレーションの非同期キャンセルを開始します。
delete DELETE /v11/{name=customers/*/operations/*}
長時間実行オペレーションを削除します。
get GET /v11/{name=customers/*/operations/*}
長時間実行オペレーションの最新状態を取得します。
list GET /v11/{name=customers/*/operations}
リクエスト内の指定したフィルタに一致するオペレーションを一覧表示します。
wait POST /v11/{name=customers/*/operations/*}:wait
指定した長時間実行オペレーションが完了するまで待機するか、指定したタイムアウトに達して最新状態を返します。

REST リソース: v11.customers.paymentsAccounts

Methods
list GET /v11/customers/{customerId}/paymentsAccounts
ログインしたお客様 ID と階層内で指定された指定した顧客の間の、すべてのマネージャーに関連付けられたすべてのお支払いアカウントを返します。

REST リソース: v11.customers.recommendations

Methods
apply POST /v11/customers/{customerId}/recommendations:apply
指定された推奨事項とそれに対応する適用パラメータを適用します。
dismiss POST /v11/customers/{customerId}/recommendations:dismiss
指定された推奨事項を閉じます。

REST リソース: v11.customers.remarketingActions

Methods
mutate POST /v11/customers/{customerId}/remarketingActions:mutate
リマーケティング アクションを作成または更新します。

REST リソース: v11.customers.sharedCriteria

Methods
mutate POST /v11/customers/{customerId}/sharedCriteria:mutate
共有条件を作成または削除します。

REST リソース: v11.customers.sharedSets

Methods
mutate POST /v11/customers/{customerId}/sharedSets:mutate
共有セットを作成、更新、削除します。

REST リソース: v11.customers.smartCampaignSettings

Methods
mutate POST /v11/customers/{customerId}/smartCampaignSettings:mutate
キャンペーンのスマート キャンペーンの設定を更新します。

REST リソース: v11.customers.userLists

Methods
mutate POST /v11/customers/{customerId}/userLists:mutate
ユーザーリストを作成または更新します。

REST リソース: v11.geoTargetConstants

Methods
suggest POST /v11/geoTargetConstants:suggest
GeoTargetConstant の候補をロケーション名またはリソース名で返します。

REST リソース: v11.googleAdsFields

Methods
get GET /v11/{resourceName=googleAdsFields/*}
リクエストされたフィールドのみを返します。
search POST /v11/googleAdsFields:search
検索クエリに一致するすべてのフィールドを返します。

REST リソース: v11.keywordThemeConstants

Methods
suggest POST /v11/keywordThemeConstants:suggest
キーワードのテーマで KeywordThemeConstant の提案を返します。