login-customer-id
login-customer-id, Google Ads API isteklerinde üzerinden işlem yapılan yönetici hesabının müşteri kimliğini taşıyan ve hedef hesap adına yapılan çağrıyı hiyerarşideki hangi hesabın yetkilendirdiğini belirten bir HTTP başlığıdır.
Her Google Ads API isteği bir müşteri kimliğini hedefler: kampanyalarını okuduğunuz ya da değiştirdiğiniz hesap. Bu hesaba bir yönetici hesap (MCC) üzerinden erişiyorsanız API'nin ayrıca oraya hangi yoldan geldiğinizi de bilmesi gerekir. login-customer-id tam olarak bunu yapar; yetkisini kullandığınız yönetici hesabı belirtir ve tireleri kaldırılmış on hane olarak gönderilir (123-456-7890 değil, 1234567890).
Basit kural şu: OAuth kimlik bilgileriniz hedef hesaba doğrudan erişen bir kullanıcıya aitse başlığı genelde göndermeyebilirsiniz. Erişim bir yönetici hesap üzerinden geliyorsa — ajansların ve MCC'ye verilmiş geliştirici token'ı kullanan herkesin normal durumu — başlık zorunludur. Bu başlığı unutmak, hesabı web arayüzünde gayet rahat görebilen geliştiricilerin aldığı USER_PERMISSION_DENIED hatasının en yaygın sebeplerinden biridir; çünkü arayüz aynı çözümlemeyi sessizce kendisi yapar, API yapmaz.
Daha ince bir kullanımı daha var. Çok katmanlı yapılarda bu başlık hangi yöneticinin bağlamının geçerli olacağını belirler ve bu bağlam ne görebileceğinizi de etkiler: paylaşılan bütçeler, hesaplar arası dönüşüm işlemleri ve hesap düzeyi ayarlar giriş yaptığınız yöneticiye göre çözümlenir. İç içe yapıda yanlış MCC göndermek düpedüz hata yerine eksik veri döndürebilir; bunu fark etmek çok daha zordur.
Opus Growth'un ortadan kaldırdığı tesisat işi tam olarak budur. Bağlayıcıyı barındırılmış (hosted) bir servis olarak çalıştırdığımız için yönetici bağlamı her çağrıda sizin adınıza çözülür: Google ile bir kez giriş yaparsınız, geliştirici token'ı, müşteri kimliği başlığı ya da OAuth yenileme döngüsüyle hiç uğraşmazsınız.
Sıkça sorulan sorular
Bir hesaba doğrudan değil de yönetici hesap üzerinden eriştiğiniz her durumda. Bu, neredeyse tüm ajans kurulumlarını ve MCC'ye verilmiş geliştirici token'ı kullanan tüm entegrasyonları kapsar. Doğrudan erişimli hesaplarda genelde gerekmez.
En sık USER_PERMISSION_DENIED, bazen CUSTOMER_NOT_ENABLED veya genel bir yetkilendirme hatası alırsınız; aynı kullanıcı hesabı Google Ads arayüzünde sorunsuz açabiliyor olsa bile.
Tireleri kaldırılmış on hane olarak. Arayüzde 123-456-7890 görünen hesap, başlıkta 1234567890 şeklinde gönderilir.
