Идентификатор клиента (customer ID) — это десять цифр, которыми Google называет один рекламный аккаунт: в интерфейсе Google Ads он пишется 123-456-7890, а везде, где его принимает API, — 1234567890. Каждый вызов здесь называет один такой аккаунт: по какому из них вы строите отчёт, в каком предлагаете изменение, к какому относится история изменений.
Аккаунт вам передают, а не находят
Аккаунт нельзя искать, и назвать тот, который вам не передавали, тоже нельзя. GET /google-ads/v1/accounts возвращает те аккаунты, в которых может работать ваша организация, и любой другой вызов принимает одно из этих значений. Идентификатор, которого нет в списке, получает ответ как на несуществующий аккаунт — 404, а не 403, и теми же словами, поэтому нельзя отличить настоящий аккаунт, к которому у вас нет доступа, от номера, которым никто не владеет.
Этот же список говорит, что в каждом аккаунте можно делать. may_change true означает, что в нём можно предлагать изменения; false — что аккаунт можно только читать и строить по нему отчёты, и ничего больше, и многие действующие аккаунты с этого начинают и на этом остаются.
Десять цифр, с дефисами или без — подойдёт любой вариант. API приводит то, что вы отправили, к единому виду и отвечает в том, с дефисами, который читает человек.
Вопросы, которые задают
Как добавить аккаунт в этот список?
Его должен кто-то передать. Либо партнёр назначает вашей организации один из своих связанных аккаунтов, либо ваша организация называет собственный аккаунт и просит, чтобы за ним присматривали специалисты, — и в обоих случаях приглашение принимается внутри Google Ads тем, кто владеет аккаунтом.
Может ли агент угадать идентификатор?
Он может отправить любые десять цифр и получит ответ, что аккаунта не существует, — тот же, что и на номер, которым никто никогда не пользовался. Пробуя, ничего не узнать.
Один аккаунт или несколько?
Столько, сколько вам передали. Каждый вызов называет один аккаунт, так что ассистент, работающий с несколькими, просто каждый раз называет другой.