mcpField
D
data-manager-api-setup

data-manager-api-setup

github.com/google開発21.6k6.4k 回インストール今日更新
リポジトリ

data-manager-api-setup について

Data Manager API の認証と利用に向けたセットアップガイドです。API の有効化、ユーザーまたはサービスアカウントの ADC 設定、認証情報の確認、各言語のクライアントライブラリとユーザー識別子処理用ユーティリティの導入を説明します。

主な機能

  1. 01Data Manager API の有効化
  2. 02ユーザーまたはサービスアカウントの ADC 設定
  3. 03認証情報の確認とアクセス問題の調査
  4. 04各言語のクライアントライブラリ導入
  5. 05ユーザー識別子の形式調整と保護

活用シーン

  1. 01API 利用に向けた Google Cloud プロジェクトの準備
  2. 02ローカル開発用の認証設定
  3. 03識別子取り込み用ライブラリの導入

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/google/skills --skill data-manager-api-setup

インストール後、Claude Code で/data-manager-api-setupを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
dotnet.md
java.md
node.md
partner-links.md
php.md
python.md

詳細

Data Manager API の設定

認証の設定

詳しくは、API アクセスの設定を参照してください。

1. API を有効にする

前提条件：Google Cloud プロジェクト、Google Cloud CLI（gcloud）、および オーナー、編集者、Service Usage 管理者など、API を有効にできるプロジェクトロールを持つ Google アカウントが必要です。必要なロールについては、必ずユーザーに伝えてください。gcloud がインストールされていない場合は、先にインストールするようユーザーに案内してください。

gcloud services enable datamanager.googleapis.com --project={project_id}
gcloud services list --enabled --project=PROJECT_ID --filter="datamanager.googleapis.com"
2. Application Default Credentials（ADC）を生成する

ユーザーの状況に合った方法を選択してください。

  • ユーザーアカウント（ユーザー自身の Google アカウントとして API 呼び出しを行う場合）：Data Manager API のスコープは機密性が高いため、ユーザーはまずプロジェクトの Google 認証プラットフォームを設定する必要があります。

    1. データアクセスページ：Data Manager API のスコープを追加します。

    2. 対象ユーザーページ：公開ステータスをテストに設定します。Google Workspace 組織の場合はユーザータイプに内部を、そうでない場合は外部を選択し、ユーザーのアカウントをテストユーザーとして追加します。

    3. デスクトップアプリの OAuth クライアントを作成する（または既存のものを使用する）と、その JSON 設定ファイルをダウンロードします。

    4. ユーザーが次のコマンドを実行すると、ブラウザーでログイン画面が開きます。

      gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/cloud-platform" \
  --client-id-file="{client_id_file_path}"

    未確認アプリの画面：Data Manager API のスコープは機密性が高いため、この警告が表示されます。テスト中は、外部のテストユーザーにも表示されますが、そのまま進むことができます。ほかのユーザーがログインする前に、アプリはOAuth アプリの確認を完了する必要があります。サービスアカウントでは確認は不要です。

  • サービスアカウント（個人ではなくアプリの ID として API 呼び出しを行う場合）：ローカル開発では、適切に管理されないとセキュリティリスクとなるサービスアカウントキーではなく、サービスアカウントの偽装を使用してください。

    • サービスアカウントに、プロジェクト上で Service Usage Consumer IAM ロール（roles/serviceusage.serviceUsageConsumer）を付与します。

    • gcloud を実行するユーザーに、そのサービスアカウント上で Token Creator ロール（roles/iam.serviceAccountTokenCreator）を付与します。

    • 次を実行します。

      gcloud auth application-default login \
  --impersonate-service-account={service_account_email} \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/cloud-platform"

  • 広告主アカウントでパートナーリンクを作成するデータパートナー：パートナーリンクを参照してください。

複数の API：同じ認証情報をほかの API で使用するには、上記のコマンドの --scopes リストにその API のスコープを追加します（例：Google Ads API の場合は https://www.googleapis.com/auth/adwords、Display & Video 360 API の場合は https://www.googleapis.com/auth/display-video）。

確認：認証情報が正しく設定されていれば、gcloud auth application-default print-access-token を実行するとアクセストークンが出力されます。

有効なトークンで PERMISSION_DENIED が発生する場合のトラブルシューティング：宛先アカウント（Google Ads アカウントまたはそのマネージャーアカウントなど）に、ユーザーまたはサービスアカウントを追加します。サービスアカウントの場合は、Cloud プロジェクトで Service Usage Consumer ロールが付与されていることも確認してください。

本番環境：本番環境での認証（Google Cloud 内外のワークロード、ほかのユーザーに代わって動作するアプリ、パートナーリンク）については、本番環境へのデプロイを参照してください。

クライアントとユーティリティライブラリのインストール

詳細については、クライアントライブラリのインストールを参照してください。

付属のユーティリティライブラリには、ユーザー識別子（メールアドレス、電話番号、住所など）を API に取り込む前に、正しくフォーマット、ハッシュ化、暗号化するためのヘルパークラスと関数があらかじめ用意されています。ユーザー識別子のフォーマットが API の仕様に準拠するよう、これらのライブラリを使用することを強くおすすめします。

以下から、言語別のインストールガイドを選択してください。

コメント

Markdown 対応