Google Ads 보고서 실행은(는) /google-ads/v1/accounts/{customer_id}/report에 대한 GET이며, Top-Rated Team Google Ads API에 속합니다. 조직에 배정된 Google Ads 계정을 다룹니다. 모든 요청은 X-API-KEY 헤더에 자신의 키를 싣습니다. 키는 LinkedIn API의 키와 같고, 조직에 배정된 계정에만 닿습니다. 아무도 배정하지 않은 계정은 존재하지 않는 계정으로 응답합니다.
여기서는 어떤 것도 계정을 스스로 바꾸지 않습니다. 변경은 먼저 제안되고, Google이 검증해 기록해 두며, 사람이 적용할 때 실행됩니다. 되돌리는 데 필요한 내용을 먼저 기록해 두므로 원래대로 되돌릴 수 있습니다.
요청
curl -X GET "https://top-rated.team/google-ads/v1/accounts/$CUSTOMER_ID/report" \ -H "X-API-KEY: $MAKEHYBRID_KEY"
경로에 들어가는 것
- customer_id — 이 계열의 앞선 호출이 돌려준 id.
안 될 때 돌아오는 것
- 401 — 키가 없거나, 틀렸거나, 폐기되었습니다.
- 402 — 요금제가 결제되지 않았습니다. 체험이 끝나면 Top-Rated Team API가 이것을 돌려줍니다.
- 404 — 그것이 없거나, 조직의 것이 아니거나. id를 떠볼 수 없도록 둘 다 일부러 같은 답을 줍니다.
- 429 — 요청이 너무 많거나, 플랫폼이 속도를 늦추라고 요청하고 있습니다. 잠시 기다린 뒤 다시 시도하세요.
- 502 또는 503 — 플랫폼이 방금 응답하지 않았습니다. 잠시 뒤에 다시 시도하세요.
모든 오류는 같은 모양의 JSON입니다: {"type":"errors/<code>","status":<n>,"detail":"..."} — 핸들러 하나로 전부 받을 수 있고, detail은 사람에게 보여 주려고 쓴 문장입니다.
대신 어시스턴트에게 부탁하기
이 작업은 MCP 도구이기도 합니다. https://top-rated.team/google-ads/mcp/<your API key>를 Claude나 ChatGPT, 또는 MCP를 말하는 아무 어시스턴트에나 붙여 넣고 평범한 말로 부탁하세요 — 어시스턴트가 호출을 고르고 id를 채우고 답을 읽어 줍니다. https://top-rated.team/mcp/<your API key>의 올인원 에이전트에도 들어 있어서 LinkedIn API 및 다른 모든 채널과 함께 쓸 수 있습니다.
프로젝트 룸에서
프로젝트 룸에서 내 AI 에이전트의 「사용할 수 있는 서버」 아래 이 API의 에이전트를 체크하면, 대화에 필요할 때마다 에이전트가 “Google Ads 보고서 실행”을(를) 도구로 호출합니다. 룸의 모두가 에이전트가 무엇을 요청했고 무엇이 돌아왔는지 볼 수 있습니다. 평범한 말로 부탁하세요. 여기서는 에이전트의 이름이 @scout입니다:
- @scout 지난주 검색어에서 돈을 가장 많이 낭비한 게 뭔지 알려 주고, 제외 키워드는 실행 전에 누군가 읽어 볼 수 있게 제안으로 작성해 줘.
자주 묻는 질문
AI 에이전트가 나 대신 “Google Ads 보고서 실행”을(를) 호출할 수 있나요?
네. MCP를 지원하는 어시스턴트라면 위의 주소로 호출할 수 있고, 이 API의 에이전트를 체크한 프로젝트 룸의 내 AI 에이전트도 호출할 수 있습니다. 룸의 내장 에이전트는 할 수 없습니다. 조언만 할 뿐 내 키를 갖고 있지 않습니다.
룸 밖에서, 내 코드로도 되나요?
네. 위의 요청은 AI 에이전트의 도구가 호출하는 것과 같은 작업이며, 답도 오류도 같습니다. 어느 길로 들어오든 키가 닿는 채널은 같습니다.
내 브랜드의 룸에서도 되나요?
네. 화이트 라벨 주소에서는 API와 그 레퍼런스, AI 에이전트가 내 제품 이름으로 표시되며, 같은 규칙에 따라 같은 채널에 닿습니다.
어느 요금제인지
Top-Rated Team API 요금제에 포함되며, LinkedIn API와 같은 키를 씁니다. 시트 하나당 월 9달러, 백 개부터는 7달러. 필요한 시트 수는 LinkedIn 계정, WhatsApp 번호, X 계정, 받은편지함 계정 중 가장 많이 가진 종류의 수와 같고, 30일 체험은 시트 하나에 대해서입니다.