Skip to content

Instantly share code, notes, and snippets.

@amashigeseiji
Last active March 1, 2016 08:43
Show Gist options
  • Save amashigeseiji/9e1bab3b3f9b6d19f01e to your computer and use it in GitHub Desktop.
Save amashigeseiji/9e1bab3b3f9b6d19f01e to your computer and use it in GitHub Desktop.
AdWords API について

AdWords API

ウェブサービスの概要

  • キャンペーンデータ管理
  • 最適化
  • アカウント管理
  • ユーティリティ

キャンペーンデータ管理

AdWords のキャンペーンやそれに関連するアイテムを使用するには、キャンペーン データ管理サービスを使用します。 各キャンペーン データ管理サービスは、キャンペーン データ階層のアイテムに対応しています(キャンペーン データの概要に記載されています)。

ITEM description
CampaignService キャンペーンの作成、更新、および削除を行います。キャンペーンとは 1 つ以上の広告グループをまとめたもので、独自の予算、入札単価設定、広告配信期間、およびターゲット設定があります。
CampaignTargetService キャンペーンの広告を表示する場所と時間を選択するには、ターゲット設定オプションを設定します。 このサービスの機能はいずれ CampaignCriterionService に統合される予定です。
AdGroupService 広告グループの作成、更新、および削除を行います。 広告グループは広告とクライテリアのセットをまとめたもので、そのクライテリアに対するデフォルトの入札単価を提供します。
AdGroupAdService 広告の作成、更新、および削除を行います。
AdParamService 広告パラメータを設定し、テキスト広告に埋め込んだパラメータ部分を迅速に更新できます。
CampaignAdExtensionService, AdExtensionOverrideService 広告設定オプションの作成、更新、および削除を行います。 キャンペーンの広告設定オプションでは、住所情報、追加リンク、電話番号などをキャンペーン内のすべての広告に追加することにより、標準のテキスト広告をより充実した内容に拡張します。 広告設定オプションで優先住所を使用すると、広告ごとに個別の住所を指定できます。
CampaignCriterionService, AdGroupCriterionService クライテリアの作成、更新、および削除を行います。 クライテリアは、広告を表示する必要があるかどうかを決定する条件を表します。
ConversionTrackerService 広告をクリックした後のユーザー行動を調べることによって、広告およびキーワードの効果を計測します。
DataService 指定されたクライテリアに基づいて広告キャンペーン管理データを取得します。
UserListService ユーザー リストの作成、更新、および削除を行います。 ユーザー リストとユーザー リスト クライテリアは、これまでにウェブサイトでコンバージョン イベントを行ったユーザーに広告を表示するときに使用します。

最適化

最適化サービスを使用すると、掲載結果の統計情報を取得し、新たなクライテリア(キーワードやプレースメントなど)の候補を見つけることができます。

ITEM DESCRIPTION
ReportDefinitionService さまざまな掲載結果レポートを作成およびダウンロードします。
TargetingIdeaService 指定したパラメータに基づいて新しいキーワードやプレースメントの候補を生成します。
TrafficEstimatorService(v201008 で追加) 提案されたキャンペーン、広告グループ、およびキーワードに関するトラフィックの見積もりを出します。

アカウント管理

アカウント管理サービスは、API ユニットの使用量やアカウントの利用状況をトラッキングするときに使用します。

ITEM DESCRIPTION
AlertService(v201008 で追加) 指定したアカウントのすべてのクライアント センター アラートを取得します。
CustomerSyncService(v201008 で追加) 指定した期間内のキャンペーン データの変更内容の記録を取得します。
InfoService 指定した期間に消費された API ユニット数などの API 使用状況情報を取得します。
ServicedAccountService(v201008 で追加) 呼び出し元アカウントが管理するアカウントの階層を取得します。

ユーティリティ

これらのユーティリティ サービスは、AdWords API でその他の作業を実行するときに必要に応じて使用します。

ITEM DESCRIPTION
MutateJobService 大規模な一括変換ジョブを非同期で送信します。 このサービスは、 BulkMutateJobService よりも使いやすく、いずれ置き換えられる予定です。
BulkMutateJobService 大量のキャンペーン データ オペレーションを非同期で処理します。 一括変換ジョブは標準的なウェブ サービスの同期呼び出しよりも時間がかかりますが、処理されたオペレーションの費用は半分になります。
GeoLocationService 指定した住所の座標と正規住所を取得します。
MediaService メディアベースの広告(イメージ広告、動画広告など)で使用するメディアのアップロードおよび ID の取得を行います。
ConstantDataService API で使用する定数値を取得します。
LocationCriterionService 場所のクライテリアの ID を取得します。
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment