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

Google Ads kullanıcılarının kimliğini doğrulamak ve yetkilendirmek için Google'ın OAuth2 sunucularına erişmek üzere kimlik bilgileri gerekir. Bu kimlik bilgileri, uygulamanızı Google'a tanımlar 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.

Cloud projesiyle ilgili en iyi uygulamalar için bu videoyu izleyin

Google OAuth doğrulaması

Google Ads API kapsamı için kimlik bilgileri elde etmek üzere kullanılan tüm Google Cloud uygulamalarının, kullanıcılarına doğrulanmamış bir kullanıcı arayüzü ekranı göstermemek için Google OAuth doğrulamasından geçmesi gerekir. Bu bağlamda uygulama, Google Cloud'da benzersiz bir OAuth 2.0 istemci kimliği olarak tanımlanır.

Bu doğrulama, geliştirici jetonu onay sürecinin bir parçası olarak yapılan incelemelere ek olarak bağımsızdır ve Google Ads API kapsamı hassas bir kapsam olduğundan gereklidir.

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

İşletmenizin kesintiye uğramaması için tüm uygulamaların Google OAuth doğrulama sürecini en kısa sürede tamamlamasını ö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.

Önemli Bilgi: Faturalandırmayı etkinleştirdiyseniz (ör. Google Cloud için) yeni proje için bir faturalandırma hesabı seçmeniz gerekir.

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

Projenizde Google Ads API'yi etkinleştirme

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

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

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

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

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

API'yi etkinleştirdikten sonra projenizin Kullanıcı türünü ve Yayınlama durumunu belirtmeniz gerekir. Aşağıdaki tabloda, bu ayarların her bir kombinasyonunun bazı 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 bir 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 şirket içi kullanıcılar olmalıdır. Yetkilendirmelerin süresi, izin verildiği tarihten itibaren 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 tüm kullanıcılar olabilir. Yetkilendirmelerin süresi, izin verildiği tarihten itibaren yedi gün sonra dolar.
Dahili	Üretimde	Yalnızca bir Google Cloud kuruluşuyla ilişkili projelerde kullanılabilir. Google Cloud kuruluşunda projeyle ilişkili tüm kullanıcıların yetkilendirilmesine izin verir.
Harici	Üretimde	Tüm projelerde kullanılabilir. Google Hesabı olan tüm kullanıcıların yetkilendirilmesine olanak tanır.

Google OAuth doğrulamasının tamamlanmaması, projenizin kullanıcı türünden veya yayınlama durumundan bağımsız olarak aşağıdaki sonuçlara yol açar:

• 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 kullanıcı rızası 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 ÇIKAR'ı 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 ardından 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'ı tıklayın.

6. Özet sayfasını inceleyin ve Kontrol paneline dön'ü tıklayın.

Uygulamanızı ve yetkilendirme sürecini test ettikten sonra kontrol paneline dönüp UYGULAMANIN YAYINLAMASINI BAŞLAT'ı tıklayarak Yayınlama durumunu Test aşamasında yerine Üretim aşamasında 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. Oluşturmak istediğiniz uygulama için en uygun türün hangisi olduğunu belirlemek üzere 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önetiyorsunuz. İlk kez kullanıcıysanız veya en basit kurulumla hızlıca başlamak istiyorsanız Uygulamanız, Google kullanıcılarının kimliğini yalnızca bir makineden doğrular.
Web uygulaması	Uygulamanızın, kullanıcının Google Ads hesap verilerine erişmesine izin verebilecek bir kullanıcı olarak kimliğini 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.

Önemli Bilgi: Sunucu üzerinde çalışacak bir uygulama geliştiriyorsanız bile masaüstü uygulaması akışını seçebilirsiniz. Aradaki fark, OAuth yetkilendirmesinin yerel olarak mı yoksa uzaktan mı tamamlandığıdır. Masaüstü akışında yetkilendirmenin yerel makinede tamamlanması gerekir. Web akışında ise yetkilendirmenin Google'ın yetkilendirme sunucusunda tamamlanmasına izin verilir.

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İĞİ BİLGİLERİ OLUŞTUR'u tıklayın ve OAuth istemci kimliği'ni seçin.

   1. Bu proje için daha önce bir OAuth izin ekranı yapılandırmadıysanız bunu hemen yapmanız istenir. İ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 bunu daha sonra düzenleyebilirsiniz. İşlemi tamamladığınızda Kaydet'i tıklayın.

   2. Devam etmek için Kimlik bilgileri > KİMLİĞİ 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 ardından 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 değerini kullanın.

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

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

6. İstemci kitaplığınızı yapılandırırken İstemci Kimliğiniz ve İstemci Gizli Anahtarınız'a ihtiyacınız olacağından, onay sayfasında bu bilgileri panonuza kopyalayın. Bu ayrıntıları daha sonra kimlik bilgileri sayfasına dönerek de alabilirsiniz.