고객 ID는 Google이 광고 계정 하나를 가리키는 데 쓰는 열 자리 숫자입니다. Google Ads 화면에서는 123-456-7890으로 적고, API가 받는 곳에서는 어디서나 1234567890으로 적습니다. 여기의 모든 호출은 계정 하나를 지정합니다. 무엇을 보고할지, 어느 계정에 변경을 제안할지, 변경 기록이 어느 계정의 것인지가 그것으로 정해집니다.
계정은 건네받는 것이지 찾아내는 것이 아니다
계정을 검색할 수는 없고, 건네받지 않은 계정을 지정할 수도 없습니다. GET /google-ads/v1/accounts는 조직이 작업할 수 있는 계정을 나열하고, 다른 모든 호출은 그 목록에 있는 값을 받습니다. 목록에 없는 ID에는 존재하지 않는 계정과 같은 응답이 갑니다. 403이 아니라 404이고, 문구도 어느 쪽이든 같습니다. 그래서 손댈 수 없는 실제 계정인지, 아무도 갖고 있지 않은 숫자인지 밖에서는 구별할 수 없습니다.
그 목록은 각 계정에서 무엇이 가능한지도 알려 줍니다. may_change가 true이면 그 계정에서 변경을 제안할 수 있고, false이면 그 계정은 읽고 보고하는 용도일 뿐 그 이상은 아닙니다. 운영 중인 계정 가운데 상당수가 거기서 시작해 그대로 남습니다.
열 자리 숫자는 대시가 있어도 없어도 됩니다. API는 보낸 값을 정규화하고, 사람이 읽는 대시 형식으로 응답합니다.
자주 묻는 질문
계정을 그 목록에 올리려면 어떻게 하나요?
누군가 건네줍니다. 파트너가 연결된 계정 중 하나를 조직에 할당하거나, 조직이 자기 계정을 지정하고 전문가가 맡아 달라고 요청하는 두 가지입니다. 어느 쪽이든 초대는 Google Ads 안에서 계정의 소유자가 수락합니다.
에이전트가 ID를 추측할 수 있나요?
원하는 열 자리 숫자를 얼마든지 보낼 수 있지만, 돌아오는 것은 계정이 존재하지 않는다는 응답입니다. 아무도 쓴 적 없는 번호에 돌아오는 응답과 같으므로, 시도해 봐도 알아낼 수 있는 것은 없습니다.
계정이 하나인가요, 여러 개인가요?
전달받은 만큼입니다. 호출마다 하나를 지정하므로, 여러 계정에 걸쳐 일하는 어시스턴트는 그때마다 다른 계정을 지정할 뿐입니다.