Ambil akun Google Ads adalah GET di /google-ads/v1/accounts/{customer_id}, bagian dari Top-Rated Team Google Ads API: akun Google Ads yang diberikan kepada organisasi Anda. Setiap permintaan membawa kunci Anda sendiri di header X-API-KEY — kunci yang sama dengan LinkedIn API — dan hanya menjangkau akun yang ditugaskan kepada organisasi Anda. Akun yang tidak pernah ditugaskan kepadanya dijawab seolah-olah akun itu tidak ada.
Tidak ada yang di sini mengubah akun dengan sendirinya. Sebuah perubahan diusulkan, diperiksa oleh Google, dan dicatat, lalu dijalankan ketika seseorang menerapkannya — dengan apa yang diperlukan untuk membatalkannya dicatat lebih dulu, supaya semuanya bisa dikembalikan.
Permintaannya
curl -X GET "https://top-rated.team/google-ads/v1/accounts/$CUSTOMER_ID" \ -H "X-API-KEY: $MAKEHYBRID_KEY"
Apa yang masuk ke jalur
- customer_id — id yang dikembalikan panggilan sebelumnya di keluarga ini.
Apa yang kembali saat gagal
- 401 — kuncinya tidak ada, salah, atau sudah dicabut.
- 402 — paketnya belum dibayar. Paket Top-Rated Team API menjawab ini setelah masa coba habis.
- 404 — entah barangnya tidak ada, atau bukan milik organisasi Anda. Keduanya sengaja dijawab sama, supaya id tidak bisa diraba-raba.
- 429 — terlalu banyak permintaan, atau platform meminta kami memperlambat. Tunggu sebentar sebelum mencoba lagi.
- 502 atau 503 — platform tidak menjawab barusan. Coba lagi sebentar lagi.
Setiap galat adalah JSON dengan bentuk yang sama: {"type":"errors/<code>","status":<n>,"detail":"..."} — jadi satu penangan mencakup semuanya, dan detail-nya ditulis untuk ditunjukkan kepada orang.
Minta saja ke asisten
Operasi ini juga sebuah alat MCP. Tempel https://top-rated.team/google-ads/mcp/<your API key> ke Claude, ChatGPT, atau asisten mana pun yang berbicara MCP, lalu minta apa yang Anda mau dengan bahasa biasa — asistennya yang memilih panggilan, mengisi id, dan membacakan jawabannya. Agen serba guna di https://top-rated.team/mcp/<your API key> juga memilikinya, bersama LinkedIn API dan setiap kanal lainnya.
Di ruang proyek
Di ruang proyek, centang agen API ini di bawah “Dapat memakai” untuk agen AI Anda sendiri, dan ia memanggil “Ambil akun Google Ads” sebagai alat setiap kali percakapan memerlukannya. Semua orang di ruang melihat apa yang ia minta dan apa yang kembali. Mintalah dengan kata-kata biasa; di sini agennya bernama @scout:
- @scout cari tahu apa yang paling banyak menghabiskan uang di istilah pencarian kami minggu lalu, dan tulis kata kunci negatifnya sebagai usulan untuk dibaca seseorang sebelum dijalankan.
Pertanyaan yang sering diajukan
Bisakah agen AI memanggil “Ambil akun Google Ads” untuk saya?
Bisa. Asisten mana pun yang berbicara MCP bisa, lewat alamat di atas, begitu pula agen AI Anda sendiri di ruang proyek dengan agen API ini dicentang. Agen bawaan sebuah ruang tidak bisa: mereka menasihati, dan mereka tidak memegang kunci Anda.
Apakah ini berfungsi di luar ruang, dari kode saya sendiri?
Bisa. Permintaan di atas adalah operasi yang sama dengan yang dipanggil alat sebuah agen AI, dengan jawaban dan galat yang sama, dan kunci Anda menjangkau kanal yang sama lewat jalan mana pun Anda masuk.
Apakah ini berfungsi di ruang dengan merek saya sendiri?
Bisa. Di alamat white-label, API, rujukannya, dan agen AI-nya memakai nama produk Anda, dan menjangkau kanal yang sama dengan aturan yang sama.
Ada di paket mana
Termasuk dalam paket Top-Rated Team API, dengan kunci yang sama seperti LinkedIn API: $9 per kursi per bulan, $7 mulai seratus kursi. Jumlah kursi yang Anda butuhkan sama dengan jumlah mana pun yang paling banyak Anda punya — akun LinkedIn, nomor WhatsApp, akun X, atau akun kotak masuk — dan masa coba 30 hari mencakup satu kursi.