SHOEISHA iD

※旧SEメンバーシップ会員の方は、同じ登録情報(メールアドレス&パスワード)でログインいただけます

CodeZine編集部では、現場で活躍するデベロッパーをスターにするためのカンファレンス「Developers Summit」や、エンジニアの生きざまをブーストするためのイベント「Developers Boost」など、さまざまなカンファレンスを企画・運営しています。

特集記事

AdWords APIでレポート作成や広告の開始/停止を自動化する

  • X ポスト
  • このエントリーをはてなブックマークに追加

AdWords API利用の準備

 AdWords APIを利用するためにはアカウントを登録し、APIを利用するための認証を通す必要があります。

 ステップが多少煩雑ですので、順に見ていきましょう。

[1]MCCアカウントとテストアカウント作成

 MCC(My Client Center)アカウントを準備します。MCCアカウントは複数のAdWordsアカウントを管理するための管理アカウントです。

 まだお持ちでない場合はこちらより作成してください。メールアドレスなどフォームの項目を入力し、申込みます。

MCCアカウント申込
MCCアカウント申込

 また、開発用に使うAdWordsアカウントとしてテストアカウントを利用します。テストアカウントとは簡単にいえば「広告が出ないアカウント」で、機能については実アカウントと同じです。管理画面の右側に「これはテストアカウントです。」という表示が現れます。

テストアカウント管理画面
テストアカウント管理画面

 Googleアカウントのメールアドレス(AdWordsで使用していないもの)を準備し、こちら から申し込みます。

 完了するとテストアカウントのMCCアカウントが利用可能になり、管理画面から本サービス同様に操作できます。

[2]Developerトークンの有効化

 MCCアカウントが準備されると、管理画面のAdWords APIセンター経由でAdWords APIを利用申請できます。

 MCCアカウント管理画面右上の歯車アイコン、[アカウント設定]の順にクリックし、左側[AdWords API センター]を選択します。

 フォームに会社名や利用目的などを記入して申請します。申請が承認されると、割り当てられた開発者トークンが有効になります。

AdWords API利用申請
AdWords API利用申請

[3]開発環境構築

 開発環境を準備します。各種プログラム言語(Java、PHP、Python、.NET、Perl、Ruby)でクライアントライブラリが準備されています。

 本稿ではPythonを利用します。クライアントライブラリーは、下記からダウンロードしてインストールします。

 pipによる導入が簡単ですので下記のようにコマンドラインから導入してください。

$ pip install googleads

[4]OAuthアクセス構築

 OAuth認証には、Google Developerアカウントが必要です。Google Developer ConsoleにMCCアカウントでログインします。

 プロジェクトを作成し、左側の[認証情報]から[認証情報の作成][OAuthクライアントID]の順に進みます。

OAuth認証情報の作成
OAuth認証情報の作成

 アプリケーションの種類は必ず[その他]を選択します。

 作成したら[クライアントID][クライアントシークレット]が生成されます。後ほど必要ですのでメモしておきます。また、ここでいう[クライアント]はAdWordsのクライアントではなく、プロジェクトで開発するアプリケーションのことですのでご注意下さい。

[5]クライアントアプリケーションの設定

 クライアントライブラリのgoogleads.yamlファイルに、さきほどメモした必要な情報を記入します。

adwords:
  developer_token: (1)
  user_agent: (2)
  client_id: (3)
  refresh_token: (4)
  client_secret: (5)
  client_customer_id: (6)

 (1)には、AdWords APIセンターで有効になった開発者トークンをいれます。

 (2)は任意の文字列で、クライアントアプリケーションの名前をつけてください。

 (3)(5)は先ほどメモした内容を入れます。

 (4)はOAuthのリフレッシュトークンを入れます。クライアントライブラリの「examples/adwords/authentication」配下にある「generate_refresh_token.py」というプログラムを用いて、引数に先ほどの情報を指定して生成します。

python generate_refresh_token.py --client_id CLIENT_ID --client_secret CLIENT_SECRET

 (6)はAPIで利用したいAdWordsのクライアントIDを入れます。

[6]APIコールの確認

 APIが正しくインストールできたことを確認しましょう。

 事前に、下記のようにテストアカウントのAdWords管理画面からキャンペーンを作成しておきます。

サンプルキャンペーン
サンプルキャンペーン

 サンプルコードを実行してみましょう。

$ python campaign_get.py

 キャンペーン情報のリストが表示されれば成功です。

キャンペーン情報の取得
キャンペーン情報の取得

次のページ
基本的なコードの流れ

この記事は参考になりましたか?

  • X ポスト
  • このエントリーをはてなブックマークに追加
特集記事連載記事一覧

もっと読む

この記事の著者

山田 祥寛(ヤマダ ヨシヒロ)

静岡県榛原町生まれ。一橋大学経済学部卒業後、NECにてシステム企画業務に携わるが、2003年4月に念願かなってフリーライターに転身。Microsoft MVP for Visual Studio and Development Technologies。執筆コミュニティ「WINGSプロジェクト」代表。主な著書に「独習シリーズ(Java・C#・Python・PHP・Ruby・JSP&サーブレットなど)」「速習シリーズ(ASP.NET Core・Vue.js・React・TypeScript・ECMAScript、Laravelなど)」「改訂3版JavaScript本格入門」「これからはじめるReact実践入門」「はじめてのAndroidアプリ開発 Kotlin編 」他、著書多数

※プロフィールは、執筆時点、または直近の記事の寄稿時点での内容です

WINGSプロジェクト 西 潤史郎(ニシ ジュンシロウ)

WINGSプロジェクトについて>有限会社 WINGSプロジェクトが運営する、テクニカル執筆コミュニティ(代表 山田祥寛)。主にWeb開発分野の書籍/記事執筆、翻訳、講演等を幅広く手がける。2018年11月時点での登録メンバは55名で、現在も執筆メンバを募集中。興味のある方は、どしどし応募頂きたい。著書記事多数。 RSS Twitter: @yyamada(公式)、@yyamada/wings(メンバーリスト) Facebook<個人紹介>フリーランスとしてデータ解析エンジニアとして主にビッグデータ関連の仕事をしています。TableauなどBIやビッグデータ処理などビジネスデータ解析環境の構築・運用、また解析系のアプリケーション開発やGoogleアナリティクス活用支援などを行っています。

※プロフィールは、執筆時点、または直近の記事の寄稿時点での内容です

この記事は参考になりましたか?

この記事をシェア

  • X ポスト
  • このエントリーをはてなブックマークに追加
CodeZine(コードジン)
https://codezine.jp/article/detail/9466 2016/06/22 14:00

おすすめ

アクセスランキング

アクセスランキング

イベント

CodeZine編集部では、現場で活躍するデベロッパーをスターにするためのカンファレンス「Developers Summit」や、エンジニアの生きざまをブーストするためのイベント「Developers Boost」など、さまざまなカンファレンスを企画・運営しています。

新規会員登録無料のご案内

  • ・全ての過去記事が閲覧できます
  • ・会員限定メルマガを受信できます

メールバックナンバー

アクセスランキング

アクセスランキング