カスタマー ID とは、Google が広告アカウントをひとつ指すために使う 10 桁の数字です。Google Ads の画面では 123-456-7890 と書かれ、API が受け取る場所ではどこでも 1234567890 と書きます。ここでの呼び出しはすべてアカウントをひとつ指定します。何をレポートするか、どのアカウントに変更を提案するか、変更の記録がどのアカウントのものか、がそれで決まります。
アカウントは渡されるもので、見つけるものではない
アカウントを検索することはできず、渡されていないアカウントを指定することもできません。GET /google-ads/v1/accounts は、あなたの組織が作業してよいアカウントを一覧にして返し、ほかのすべての呼び出しはその一覧にある値を受け取ります。一覧にない ID には、存在しないアカウントと同じ応答が返ります。403 ではなく 404 で、文面もどちらも同じです。そのため、触れてはいけない実在のアカウントなのか、誰のものでもない数字なのかを、外から見分けることはできません。
その一覧は、各アカウントで何ができるかも示します。may_change が true なら、そこでは変更を提案できます。false なら、そのアカウントは読んでレポートするためのものでそれ以上のことはできず、運用中のアカウントの多くはそこから始まり、そのままです。
10 桁の数字は、ダッシュありでもなしでも構いません。API は送られたものを正規化し、人が読む、ダッシュ付きの形で応答します。
よくある質問
アカウントをその一覧に載せるには？
誰かが渡します。パートナーが、リンクしているアカウントのひとつをあなたの組織に割り当てるか、あなたの組織が自分のアカウントを指定して専門家に見てもらうよう頼むか、のどちらかです。どちらの場合も、招待は Google Ads の中で、そのアカウントの所有者が承諾します。
エージェントは ID を推測できますか？
好きな 10 桁の数字を送ることはできますが、返ってくるのはアカウントが存在しないという応答です。誰も使ったことのない番号に返る応答と同じなので、試してみても分かることは何もありません。
アカウントは 1 つですか、複数ですか？
渡された数だけです。呼び出しごとにひとつを指定するので、複数をまたいで働くアシスタントは、そのたびに別のものを指定するだけです。