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

Google Ads kullanıcılarının kimliklerini doğrulamak ve yetkilendirmek için Google'ın OAuth2 sunucularına erişmek için gereken kimlik bilgileri gereklidir. Bu kimlik bilgileri, uygulamanızı Google'a tanıtarak Google Ads kullanıcılarını yönetmek için OAuth jetonları oluşturabilmenizi sağlar. Google OAuth2 kimlik bilgilerine erişim Google API Konsolu'ndan yönetilir.

Cloud projesiyle ilgili en iyi uygulamalardan bazıları için bu videoyu izleyin

Google OAuth doğrulaması

Google Ads API kapsamıyla ilgili kimlik bilgilerini almak amacıyla kullanılan tüm Google Cloud uygulamaları, kullanıcıları için doğrulanmamış kullanıcı arayüzü ekranından kaçınmak üzere Google OAuth doğrulamasından geçmelidir. Bu bağlamda bir uygulama, Google Cloud'da benzersiz bir OAuth 2.0 İstemci Kimliği olarak tanımlanır.

Bu doğrulama bağımsızdır ve geliştirici jetonu onay süreci kapsamında gerçekleştirilen incelemelere ek olarak gerçekleştirilir. Google Ads API kapsamı hassas bir kapsam olduğu için zorunludur.

Google doğrulaması için ücret alınmaz. Bu doğrulama işlemi genellikle 3 ila 5 iş günü içinde tamamlanır. Bu politika tüm uygulamalar için geçerlidir.

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

Proje oluşturma

Google API Konsolu'na gidin. Create project (Proje oluştur) seçeneğini tıklayın, bir ad girin ve Create'i (Oluştur) tıklayın.

Önemli Nokta: Faturalandırmayı etkinleştirdiyseniz (örneğin Google Cloud'da) yeni proje için bir faturalandırma hesabı seçmeniz gerekir.

Google Ads API kullanımı için ücret alınmaz ancak Cloud projelerinin toplam sayısı için bir kota vardır. Alternatif olarak, ücretsiz proje kotası içeren yeni bir Google Hesabı'na da kaydolabilirsiniz.

Projenizde Google Ads API'yi etkinleştirme

Projenizde Google Ads API'yi etkinleştirmek için şu 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ığı, ürün ailesine ve popülerliğe göre gruplandırılmış şekilde tüm kullanılabilir API'leri listeler.

2. Google Ads API listede görünmüyorsa bulmak için arama özelliğini kullanın.

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

Kullanıcı türü ve yayınlama durumunu seçin

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

Kullanıcı türü	Yayınlanma durumu	Sınırlamalar
Dahili	Test	Yalnızca bir Google Cloud Kuruluşu ile ilişkili projeler için kullanılabilir. OAuth izin ekranında listelenen en fazla 100 test kullanıcısıyla sınırlıdır. Test kullanıcıları, projeyle ilişkili Google Cloud Kuruluşunda bulunan dahili kullanıcılar olmalıdır. Yetkilendirmelerin süresi, rıza tarihinden itibaren yedi gün içinde dolar.
Harici	Test	Tüm projeler için kullanılabilir. OAuth izin ekranında listelenen en fazla 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, rıza tarihinden itibaren yedi gün içinde dolar.
Dahili	Üretimde	Yalnızca bir Google Cloud Kuruluşu ile ilişkili projeler için kullanılabilir. Projeyle ilişkili Google Cloud Kuruluşu içindeki tüm kullanıcıların yetkilendirilmesine izin verir.
Harici	Üretimde	Tüm projeler için kullanılabilir. Google Hesabı olan tüm kullanıcıların yetkilendirilmesine olanak tanır.

Google OAuth doğrulaması tamamlanmadığında, projenizin Kullanıcı türü veya Yayınlama durumundan bağımsız olarak şunlar elde edilir:

• 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 izin ekranını yapılandırın

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 bu bilgiyi daha sonra düzenleyebilirsiniz. İşiniz bittiğinde KAYDET VE DEVAM ET'i tıklayın.

4. Bir sonraki sayfada, SCOP EKLE VEYA KALDIR'ı tıklayın.

   • Aşağı kaydırın ve Manuel olarak kapsam ekle altındaki alana aşağıdaki bilgileri girin:

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

   • TABLOYA EKLE'yi tıklayın.

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

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

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

6. Özet sayfasını inceleyin ve GÖSTERGE TABLOSUNA DÖN'ü tıklayın.

Uygulamanızı ve yetkilendirme sürecini test ettikten sonra kontrol paneline dönebilir ve UYGULAMAYI YAYINLA'yı tıklayarak Yayınlama durumunu Test'den Üretimde'ye 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. Oluşturmak istediğiniz uygulama için hangi türün en uygun olduğunu belirlemek amacıyla aşağıdaki tabloya bakın:

Bu uygulama türünü seçin	Eğer ...
Masaüstü uygulaması	Tüm Google Ads hesaplarınızı tek bir üst düzey yönetici hesabı kullanarak yönetirsiniz. Yeni bir kullanıcıysanız veya en basit kurulumla hızlı bir başlangıç yapmak istiyorsanız. Uygulamanız, Google kullanıcılarının kimliğini yalnızca bir makineden doğrular.
Web uygulaması	Uygulamanızın Google Ads hesap 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 çok yetkilendirme kimlik bilgisini kolayca oluşturmak istiyorsanız. Uygulamanız geri çağırma URL'leri gerektiriyor. Geri çağırma URL'leri, masaüstü uygulaması akışında desteklenmiyor.

Önemli Bilgi: Sunucuda çalışacak bir uygulama geliştiriyor olsanız bile masaüstü uygulaması akışını seçebilirsiniz. Aradaki fark OAuth yetkilendirmesinin yerel olarak veya uzaktan tamamlanmasıdır. Masaüstü akışı, yetkilendirmenin yerel makinede tamamlanmasını gerektirirken web akışı, yetkilendirmenin Google'ın yetkilendirme sunucusunda tamamlanmasına olanak tanır.

Ayrıntılı bilgi için masaüstü uygulamaları veya web uygulamalarıyla ilgili Google Identity Platform OAuth dokümanlarına 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. Credentials (Kimlik Bilgileri) sayfasını açın. Önceden oluşturulmuş projelerden birini seçin veya yeni proje oluşturun.

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

   1. Bu proje için daha önce OAuth izin ekranı yapılandırmadıysanız şimdi buna yönlendirileceksiniz. İZİN 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 bu bilgiyi 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 bölümüne geri dönün.

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

4. Listeye 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.

   Not: Kullanımı belirli bir bağlantı noktasıyla kısıtlamak için yönlendirme URI'nıza bir bağlantı noktası numarası ekleyebilirsiniz. Bağlantı noktası ayarlanmazsa OAuth istemcisi herhangi bir bağlantı noktasına yönlendirme yapabilir.

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

6. Onay sayfasında İstemci Kimliğiniz ve İstemci Sırrınız'ı panonuza kopyalayın. İstemci kitaplığınızı yapılandırırken bu bilgilere ihtiyacınız olacaktır. Bu bilgileri almak için daha sonra kimlik bilgileri sayfasına da dönebilirsiniz.