Google Ads'i Claude ile Yönetme: API Erişimi ve MCC Kurulumu

Google Ads'i Claude ile yönetmek nasıl çalışır?

Claude, Google Ads hesabınıza Google'ın resmî Google Ads API'si üzerinden bağlanır. Bağlantıyı Google'ın belgelediği açık kaynaklı Google Ads API Developer Assistant eklentisi kurar ve eklenti Claude Code içinde çalışır. Siz Türkçe bir istek yazarsınız; Claude isteği bir API sorgusuna ya da Python koduna çevirir.

Okuma ile değiştirme ayrı yürür. Harcama, dönüşüm ve arama terimi raporlarını Claude doğrudan çalıştırır ve sonucu tablo olarak gösterir. Kampanya oluşturma, negatif anahtar kelime ekleme ya da reklam güncelleme gibi değişikliklerde kodu saved/code/ klasörüne yazar ama çalıştırmaz; kodu siz okuyup çalıştırırsınız. Bu, eklentinin kendi güvenlik kuralıdır ve her değişikliğin hesaba sizin onayınızla gitmesini sağlar.

Google'ın resmî Google Ads MCP sunucusu salt okunurdur: rapor alır, teklif değiştirmez, kampanya durdurmaz, öğe oluşturmaz. Bu rehberdeki kurulum değişiklik kodunu da hazırlayan Developer Assistant'ı kullanır. Google Ads panelindeki yapay zekâ araçları ayrı bir konudur; onlar için Google Ads yapay zekâ özellikleri rehberine bakabilirsiniz.

Google Ads API için MCC gerekli mi? Eylül 2026 değişikliği

Google Ads API'yi kullanmak için artık MCC (yönetici hesabı) gerekmiyor. Google geliştirici jetonlarını 9 Eylül 2026'da kaldırdı ve API erişim düzeyini Google Cloud projesine taşıdı. MCC'deki API Merkezi'nden yapılan başvurular artık işleme alınmıyor; başvuru Cloud Console'dan yapılıyor.

MCC'nin rolü ise sürüyor: birden çok Google Ads hesabını API ile yönetecekseniz MCC gerekir. Servis hesabını MCC'ye kullanıcı olarak eklediğinizde MCC'ye bağlı hesaplara erişirsiniz; isteklerde login_customer_id alanına MCC'nin 10 haneli kimliği yazılır. Google bir e-posta adresinin en fazla 20 Google Ads hesabıyla ilişkilendirilebileceğini belirttiği için çok hesaplı kurulumlarda servis hesabı hesaplara tek tek değil, MCC'ye eklenir.

Daha önce API Merkezi'nden geliştirici jetonu aldıysanız erişiminiz kaybolmadı. Google, son 90 günde jetonla çağrı yapılan Cloud projelerine aynı erişim düzeyini aktardı. Kodunuz jetonu göndermeye devam edebilir; sunucular bu alanı yok sayar.

Google Ads API erişimi nasıl alınır?

Google Ads API erişimi Google Cloud Console'dan alınır ve gerçek reklam hesapları için Explorer düzeyi yeterlidir. API'yi etkinleştirdiğiniz anda proje Test erişimi alır; bu düzey yalnızca test hesaplarında çalışır. Gerçek hesabınızı yönetmek için Explorer'a başvurursunuz; Google bu başvuruların çoğunu otomatik inceleyip onaylar.

1. Google Cloud Console'da yeni bir proje açın ya da var olan projenizi seçin.
2. API kitaplığında Google Ads API'yi bulup etkinleştirin. Proje bu anda Test erişimi alır.
3. Google Ads API Genel Bakış (Overview) sayfasını açın ve erişim düzeyinin Test olarak göründüğünü kontrol edin.
4. Erişim düzeyini yükseltme (Upgrade access level) bölümünü açın, sonraki düzeyin Explorer olduğunu görün ve başvuru düğmesine (Apply for access) basın.
5. Başvurudan sonra Genel Bakış sayfasındaki erişim düzeyini kontrol edin; Google çoğu projeyi otomatik olarak Explorer'a yükseltir.

Explorer erişimi hesap oluşturma, kullanıcı yönetimi, planlama servisleri (anahtar kelime planlama dahil) ve faturalandırma işlemlerini kapsamaz; bunlar için Basic ya da Standard gerekir. Basic başvurusu için Cloud projesinde marka doğrulamasının tamamlanmış olması gerekir. Günlük sınırlar kayan 24 saatlik pencereyle hesaplanır.

Servis hesabı oluşturma ve MCC'ye ekleme

Servis hesabı, Claude'un Google Ads'e sizin Google şifreniz olmadan bağlanmasını sağlayan bir Google Cloud kimliğidir; Google'ın güncel hızlı başlangıç rehberi de bu yolu kullanır. Servis hesabını oluşturduktan sonra e-posta adresini Google Ads'e kullanıcı olarak eklersiniz. Birden çok hesap yönetecekseniz bu eklemeyi MCC'de yaparsınız.

1. Google Ads API'yi etkinleştirdiğiniz Cloud projesinde bir servis hesabı oluşturun ve e-posta adresini not edin. Adres iam.gserviceaccount.com ile biter.
2. Servis hesabı için JSON biçiminde bir anahtar oluşturup indirin.
3. MCC'nizde yönetici yetkisiyle oturum açın ve Yönetici menüsünden Erişim ve güvenlik sayfasını açın.
4. Kullanıcılar sekmesinde artı düğmesine basın, servis hesabının e-posta adresini yazın, erişim düzeyini seçin ve hesabı ekleyin.

JSON anahtarı bir şifre gibidir: kimseyle paylaşmayın, e-postayla göndermeyin, kod deposuna yüklemeyin. Anahtarın sızdığını düşünüyorsanız Cloud Console'da silip yenisini oluşturun. Servis hesapları Yalnızca e-posta erişim düzeyini desteklemez ve varsayılan olarak yönetici erişimi alamaz; kampanya yönetimi için Standart erişim yeterlidir.

Yöneteceğiniz hesapları MCC'ye bağlama

Servis hesabını MCC'ye eklediyseniz Claude yalnızca MCC'ye bağlı hesaplara erişir; bu yüzden yöneteceğiniz her hesabı önce MCC'ye bağlarsınız. İstek MCC'den gönderilir, hesap sahibi kendi hesabından onaylar. Bağlantı yönetim yetkisi verir, hesabın sahipliğini değiştirmez; ayrıntısı Google Ads hesap sahipliği rehberinde.

1. Google Ads yönetici hesabınızda oturum açın.
2. Hesaplar simgesine tıklayıp Alt hesap ayarları'nı seçin.
3. Artı düğmesine basın ve Mevcut hesabı bağla seçeneğini seçin.
4. Bağlanacak hesabın müşteri kimliğini girin (birden çok hesap için her satıra bir kimlik) ve İsteği gönder'e tıklayın.

Hesap sahibi isteği kendi Google Ads hesabında kabul eder: Yönetici menüsünden Erişim ve güvenlik sayfasına gider, Yöneticiler sekmesindeki bağlantı isteğinde Kabul et'i seçer. Davet e-postasındaki İsteği kabul et bağlantısı da aynı işi görür.

Tek bir reklam hesabınız varsa MCC açmanız gerekmez. Servis hesabını doğrudan o hesaba kullanıcı olarak eklersiniz; bu durumda yapılandırma dosyasında login_customer_id satırına ihtiyaç kalmaz.

Claude Code ve Developer Assistant kurulumu

Claude'un Google Ads'e bağlanması için bilgisayarınıza Claude Code ve Google'ın Developer Assistant eklentisi kurulur. Claude Code ücretsiz Claude planında yer almaz; Pro, Max, Team, Enterprise ya da Console hesabı gerekir. Eklenti için bilgisayarınızda Python 3.10 veya üstü ile Git kurulu olmalıdır.

1. Claude Code'u kurun: macOS ve Linux'ta terminale curl -fsSL https://claude.ai/install.sh | bash, Windows PowerShell'de irm https://claude.ai/install.ps1 | iex yazın. Ardından claude komutunu çalıştırıp tarayıcıdan oturum açın.
2. Eklentiyi indirin: git clone https://github.com/googleads/google-ads-api-developer-assistant.git
3. İndirilen klasöre girin ve kurulum betiğini Claude için çalıştırın: macOS ve Linux'ta ./install.sh claude, Windows'ta .\install.ps1 -Type claude. Betik Python istemci kitaplığını da kurar.
4. Açık bir Claude Code oturumunda /reload-plugins yazın ya da Claude Code'u yeniden başlatın.

Son parça google-ads.yaml dosyasıdır: eklentiye Google Ads'e hangi kimlikle bağlanacağını söyler ve ana klasörünüzde durur. Servis hesabı ve MCC ile kurulumda üç satır yeterlidir:

use_proto_plus: True
json_key_file_path: /Users/kullanici-adiniz/anahtarlar/servis-hesabi.json
login_customer_id: 1234567890

login_customer_id MCC'nizin 10 haneli kimliğidir ve tire olmadan yazılır. json_key_file_path indirdiğiniz JSON anahtarının tam yoludur; anahtarı proje klasörlerinin dışında tutun. Google'ın Python istemci kitaplığı 32.0.0 sürümünden beri bu dosyada geliştirici jetonu aramaz; eski bir jetonunuz yazılıysa da sorun çıkmaz.

Claude'a ne yazılır? Örnek istekler

Kurulum bitince Claude'a Türkçe yazarsınız ve hangi hesapta çalışacağını müşteri kimliğiyle belirtirsiniz. MCC'nize bağlı hesapların kimliklerini görmek için /get-cids komutunu MCC kimliğiyle çalıştırabilir ya da listeyi Claude'dan isteyebilirsiniz.

• 123-456-7890 hesabında son 30 günde harcama yapıp dönüşüm getirmeyen arama terimlerini listele.
• Bu terimleri ilgili kampanyaya negatif anahtar kelime olarak ekleyen kodu hazırla.
• Otel kampanyasındaki duyarlı arama reklamı için 15 başlık ve 4 açıklama yaz, karakter sınırlarını kontrol et.
• Arama kampanyasına 4 site bağlantısı ekleyen kodu hazırla.

Claude bir değişiklik kodu hazırladığında çalıştırmadan önce üç şeyi okuyun: hangi hesap, hangi kampanya, hangi değer. İlk denemeyi küçük bir kampanyada yapın ve sonucu Google Ads arayüzünde kontrol edin. Önerileri değerlendirirken duyarlı arama reklamı yazma ve negatif anahtar kelime kurallarını bilmek işinizi kolaylaştırır.

Kurulumda sık takılınan noktalar

Takılmaların çoğu erişim düzeyinden, servis hesabının hangi projede açıldığından ya da kimlik biçiminden gelir. Hata aldığınızda önce şu noktaları kontrol edin.

• Proje hâlâ Test erişimindeyse gerçek hesaba yapılan istekler hata verir; Genel Bakış sayfasından Explorer'a başvurun.
• Servis hesabı, Google Ads API'nin etkin olduğu Cloud projesinde oluşturulmuş olmalıdır.
• login_customer_id tiresiz 10 hane olmalı ve servis hesabının eklendiği MCC'nin kimliği olmalıdır.
• Hesap MCC'ye bağlı değilse ya da bağlantı isteği onaylanmadıysa Claude o hesabı göremez.
• Çok sayıda hesapta günlük 2.880 işlem sınırına takılıyorsanız Basic erişime başvurun.

Kurulumu ekibinize kurdurmak ya da hesap yapınızı birlikte gözden geçirmek isterseniz bize yazın.