Google Ads API ile çalışırken e-posta adresleri, iletişim ve erişim yönetimi için birden fazla yerde kullanılır. Bunlardan en önemlileri şunlardır:
- Google Ads API iletişim e-postası: Google'ın zorunlu hizmet duyuruları (MSA'lar) ve yönetim bildirimleri göndermek için kullandığı, Google Cloud projenizde Sahip veya Düzenleyici rolü atanmış e-posta adresleri.
- Google Cloud Console hesabı e-postası: OAuth 2.0 uygulamanız için kullanılan Google Cloud projesine yönetici erişimi olan e-posta adresi.
- Google Ads yönetici hesabı erişimi: Google Ads API üzerinden erişilen Google Ads yönetici hesaplarında erişim izinlerine sahip olan hizmet hesabı (önerilir) veya paylaşılan e-posta takma adı.
Bu kılavuzun geri kalanında, daha önce listelenen hesapların her biri ve entegrasyonunuzun tek bir kullanıcının e-posta adresine bağlı olmaması için bunları nasıl yapılandırabileceğiniz ayrıntılı olarak açıklanmaktadır.
Google Ads API iletişim e-postası
Google; yönetim bildirimlerini, API inceleme güncellemelerini, denetim isteklerini, zorunlu hizmet duyurularını (ZHD'ler) ve üretimle ilgili acil durum iletişimlerini Google Cloud projenizin Sahip ve Düzenleyici rolleriyle ilişkili e-posta adreslerine gönderir (Google Ads kullanıcı arayüzündeki eski API Merkezi iletişim e-postası ayarı kullanımdan kaldırıldığından Yeni API iletişim e-postaları bölümüne bakın).
İletişim e-postanızı güncellemek ve tüm ekibinizin bu bildirimleri almasını sağlamak için Google Cloud projenizdeki paylaşılan bir ekip takma adına Sahip veya Düzenleyici rolü verin ve bu takma ada gönderilen e-postaları düzenli olarak izleyin.
Google Cloud Console hesabı
Google Cloud Console projesi, uygulamanızın OAuth kimlik bilgilerini içerir ve Google Ads API'ye erişimi kontrol eder. Paylaşılan bir ekip takma adına Sahip (veya Düzenleyici) rolü vererek bu projeye erişim sağlayın.
Paylaşılan bir takma adı Google Cloud projesi sahibi olarak eklemek için aşağıdaki adımları uygulayın:
- Google Cloud Console'da oturum açın.
- Sayfanın üst kısmındaki proje seçiciden projenizi seçin.
- Gezinme menüsünde IAM & Admin > IAM'e (IAM ve Yönetici > IAM) gidin.
- Erişim İzni Ver'i tıklayın.
- Add principals (Ana hesapları ekle) bölümünde, New principals (Yeni ana hesaplar) alanına paylaşılan e-posta adresini girin.
- Assign roles (Rol atayın) bölümünde Select a role'u (Rol seçin) tıklayın ve Basic > Owner (Temel > Sahip) [veya Basic > Editor (Temel > Düzenleyici)] seçeneğini belirleyin.
- Kaydet'i tıklayın. Google Cloud kuruluşunuzun dışındaki bir e-posta adresine (veya kuruluşu olmayan bir projeye) Sahip rolü verdiyseniz Google Cloud, paylaşılan takma ada bir davet e-postası gönderir. Rolün geçerli olması için bu davetin kabul edilmesi gerekir. Erişim izni verme ve iptal etme hakkında daha fazla bilgi edinmek için Cloud belgelerine bakın.
Google Ads yönetici hesabı
Google Ads API'yi kullanarak hesapları yönetmenin yaygın bir yöntemi, tüm hesaplarınızı ortak bir yönetici hesabına bağlamak ve en üstteki yönetici hesabının kimlik bilgilerini kullanarak tüm hesaplara API çağrıları yapmaktır. Bu yapılandırmada geliştirici, login-customer-id istek başlığını (veya login_customer_id istemci kitaplığı yapılandırma ayarını) Google Ads yönetici hesabının 10 haneli müşteri kimliğine (tire olmadan) ayarlar ve hedef customer_id değerini API çağrılarının yapıldığı işletme hesabına ayarlar.
Önerilen: Hizmet hesabı kullanma
Google Ads yönetici hesabının kimliğini doğrulamak ve hesaba erişmek için hizmet hesabı kullanmak tercih edilen yaklaşımdır. Bireysel kullanıcı hesaplarının aksine, hizmet hesapları Google Cloud projeniz kapsamında yönetilir ve belirli bir kişiye bağlı değildir. Bu sayede, ekip üyeleri rol değiştirdiğinde veya şirketten ayrıldığında kesinti yaşanmaz. Hizmet hesabı oluşturmak ve Google Ads yönetici hesabınıza erişim izni vermek için hizmet hesabı kılavuzundaki adımları uygulayın.
Alternatif: Paylaşılan bir e-posta takma adı kullanma
Entegrasyonunuz bir hizmet hesabı kullanamıyorsa ve bunun yerine tek kullanıcılı kimlik doğrulama iş akışını kullanıyorsa Google Ads yönetici hesabına erişimi olan bir kullanıcı, OAuth 2.0 yenileme jetonu yayınlar.
Kullanıcı kimlik bilgilerini kullanırken bu senaryodan kaçınmak için:
- Bu Google Ads yönetici hesabını uygun erişim düzeyleriyle yönetmek için paylaşılan bir e-posta takma adını (geçiş anahtarı doğrulaması etkin olan etkin bir Google Hesabı tarafından desteklenen) davet edin.
- Paylaşılan e-posta takma adını kullanarak daveti kabul edin.
- API çağrıları yapmak için OAuth yenileme jetonunu oluşturmak üzere bu paylaşılan e-posta takma adını kullanın.