Google Ads API için Google API Konsolu Projesini Yapılandırma

Google Ads kullanıcılarının kimliğini doğrulamak ve onları yetkilendirmek için Google'ın OAuth2 sunucularına erişim kimlik bilgileri gerekir. Bu kimlik bilgileri, Google'a uygulamanızı tanıtır ve Google Ads kullanıcılarını yönetmek için OAuth jetonları oluşturmanıza olanak tanır. Google OAuth2 kimlik bilgilerine erişim, Google API Konsolu'ndan yönetilir.

Google OAuth doğrulaması

Google Ads API kapsamı için kimlik bilgileri almak üzere kullanılan tüm Google Cloud uygulamalarının, kullanıcıları için doğrulanmamış bir kullanıcı arayüzü ekranı gösterilmesini önlemek amacıyla Google OAuth doğrulaması sürecinden geçmesi gerekir. Bu bağlamda uygulama, Google Cloud'daki benzersiz bir OAuth 2.0 istemci kimliği olarak tanımlanır.

Bu doğrulama, geliştirici jetonu onay süreci kapsamında yapılan incelemelerden bağımsızdır ve bu incelemelere ek olarak yapılır. Google Ads API kapsamı hassas bir kapsam olduğundan bu doğrulama gereklidir.

Google doğrulamasının maliyeti yoktur ve doğrulama genellikle 3-5 iş günü içinde tamamlanır. Bu politika tüm uygulamalar için geçerlidir.

İşletmenizde kesinti yaşanmaması için tüm uygulamaların en kısa sürede Google OAuth doğrulama sürecinden geçirilmesini öneririz.

Proje oluşturma

Google API Konsolu'na gidin. Proje oluştur'u tıklayın, bir ad girin ve Oluştur'u tıklayın.

Projenizde Google Ads API'yi etkinleştirme

Projenizde Google Ads API'yi etkinleştirmek için aşağıdaki adımları uygulayın:

1. Google API Konsolu'nda API Kitaplığı'nı açın. İstenirse projenizi seçin veya yeni bir proje oluşturun. API Kitaplığı'nda, ürün ailesine ve popülerliğe göre gruplandırılmış tüm API'ler listelenir.

2. Listede görünmüyorsa Google Ads API'yi bulmak için aramayı kullanın.

3. Google Ads API'yi seçin ve Etkinleştir düğmesini tıklayın.

Kullanıcı türü ve yayınlanma durumu seçme

API'yi etkinleştirdikten sonra projenizin Kullanıcı türü ve Yayın durumu'nu belirtmeniz gerekir. Aşağıdaki tabloda, bu ayarların her bir kombinasyonunun temel özellikleri ve sınırlamaları vurgulanmaktadır. Daha fazla bilgi için Google Cloud Platform belgelerine bakın.

Kullanıcı türü	Yayınlanma durumu	Sınırlamalar
Dahili	Test	Yalnızca Google Cloud kuruluşuyla ilişkili projelerde kullanılabilir. OAuth izin ekranında listelenen 100 test kullanıcısıyla sınırlıdır. Test kullanıcıları, projeyle ilişkili Google Cloud kuruluşundaki dahili kullanıcılar olmalıdır. Yetkilendirmelerin süresi, izin verildikten yedi gün sonra dolar.
Harici	Test	Tüm projelerde kullanılabilir. OAuth izin ekranında listelenen 100 test kullanıcısıyla sınırlıdır. Test kullanıcıları, Google Hesabı olan herhangi bir kullanıcı olabilir. Yetkilendirmelerin süresi, izin verildikten yedi gün sonra dolar.
Dahili	Üretimde	Yalnızca Google Cloud kuruluşuyla ilişkili projelerde kullanılabilir. Projeyle ilişkili Google Cloud kuruluşundaki herhangi bir kullanıcının yetkilendirilmesine izin verir.
Harici	Üretimde	Tüm projelerde kullanılabilir. Google Hesabı olan tüm kullanıcıların yetkilendirilmesine izin verir.

Google OAuth doğrulaması işleminin tamamlanmaması, projenizin Kullanıcı türü veya Yayınlama durumu ne olursa olsun aşağıdakilere neden olur:

• Yetkilendirme işlemi sırasında kullanıcılara doğrulanmamış bir kullanıcı arayüzü ekranı gösterilir.

• Yalnızca 100 kullanıcıyı yetkilendirebilirsiniz.

OAuth onay ekranını yapılandırma

1. İzin ekranı sayfasını açın ve sayfanın üst kısmındaki açılır menüden projenizi seçin.

2. Kullanıcı Türü'nü seçin ve OLUŞTUR'u tıklayın.

3. İzin ekranı formunu doldurun. Gerekirse bunu daha sonra düzenleyebilirsiniz. İşlemi tamamladığınızda KAYDET VE DEVAM ET'i tıklayın.

4. Sonraki sayfada KAPSAM EKLE VEYA KALDIR'ı tıklayın.

   • Aşağı kaydırın ve Kapsamları manuel olarak ekle bölümündeki alana aşağıdakileri girin:

     https://www.googleapis.com/auth/adwords
     

   • TABLOYA EKLE'yi tıklayın.

   • Projenizin isteyeceği diğer kapsamları ekleyin ve GÜNCELLE'yi tıklayın.

   • KAYDET VE DEVAM ET'i tıklayın

5. Projenizi hemen yayınlamayı planlamıyorsanız test için kullanacağınız her kullanıcı hesabının e-posta adresini ekleyin ve KAYDET VE DEVAM ET'i tıklayın.

6. Özet sayfasını inceleyip KONTROL PANELİNE DÖN'ü tıklayın.

Uygulamanızı ve yetkilendirme sürecini test ettikten sonra kontrol paneline dönüp UYGULAMAYI YAYINLA'yı tıklayarak Yayınlama durumunu Test'ten Üretimde olarak değiştirebilirsiniz.

Uygulama türü seçin

Google Ads API için iki uygulama türü seçeneği vardır: Masaüstü veya Web. Hangi türün oluşturmak istediğiniz uygulama için en uygun olduğunu belirlemek üzere aşağıdaki tabloya bakın:

Bu uygulama türünü seçin	Şu durumlarda:
Masaüstü uygulaması	Tüm Google Ads hesaplarınızı tek bir üst düzey yönetici hesabı kullanarak yönetiyorsanız. İlk kez kullanıyorsanız veya en basit kurulumla hızlıca başlamak istiyorsanız. Uygulamanız yalnızca tek bir makinedeki Google kullanıcılarının kimliğini doğrular.
Web uygulaması	Uygulamanızın Google Ads hesabı verilerine erişmesine izin verebilecek bir kullanıcı olarak kimliğinizi doğrulamak istiyorsunuz. Örneğin, üçüncü taraf hesaplarını yönetmek için birden fazla yetkilendirme kimlik bilgisini kolayca oluşturmak istiyorsanız. Uygulamanız için geri çağırma URL'leri gerekiyor. Geri çağırma URL'leri, masaüstü uygulaması akışında desteklenmez.

Daha fazla bilgi için masaüstü uygulamaları veya web uygulamaları ile ilgili Google Identity Platform OAuth belgelerine bakın.

İstemci kimliği ve istemci gizli anahtarı oluşturma

Uygulama türünüzü belirledikten sonra OAuth2 istemci kimliğini ve istemci gizli anahtarını oluşturmak için aşağıdaki talimatları uygulayın:

1. Kimlik bilgileri sayfasını açın. Daha önce oluşturulmuş bir projeyi seçin veya yeni bir proje oluşturun.

2. Kimlik bilgileri ekranında KİMLİK BİLGİLERİ OLUŞTUR'u tıklayın, ardından OAuth istemci kimliği'ni seçin.

   1. Bu proje için daha önce bir OAuth izin ekranı yapılandırmadıysanız şimdi bunu yapmanız istenir. CONFIGURE CONSENT SCREEN'i (KULLANICI RIZASI EKRANINI YAPILANDIR) tıklayın.

      1. Kullanıcı türünü seçin ve OLUŞTUR'u tıklayın.

      2. İlk formu doldurun. Gerekirse bunu daha sonra düzenleyebilirsiniz. İşiniz bittiğinde Kaydet'i tıklayın.

   2. Devam etmek için Kimlik Bilgileri > KİMLİK BİLGİLERİ OLUŞTUR > OAuth istemci kimliği'ne geri dönün.

3. Kullanım alanınıza bağlı olarak uygulama türü olarak Masaüstü uygulaması veya Web uygulaması'nı seçin.

4. Bir ad verin ve Oluştur'u tıklayın.

5. İstemci türünüz Web uygulaması ise en az bir yetkili yönlendirme URI'si ekleyin.

   İstemci kitaplığı örneklerimizdeki varsayılan yapılandırmayla uyumlu yerel test için http://127.0.0.1 kullanın.

   Masaüstü uygulaması istemcilerinde, geri döngü IP yönlendirmesi kullanmaya devam edersiniz ancak URI, Cloud Console'da açıkça yapılandırılmaz.

6. Onay sayfasında, istemci kitaplığınızı yapılandırırken ihtiyacınız olacağı için İstemci Kimliğiniz ve İstemci Gizli Anahtarınız'ı panonuza kopyalayın. Bu ayrıntıları almak için daha sonra kimlik bilgileri sayfasına da dönebilirsiniz.