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şim için 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şturmanıza olanak tanır. Google OAuth2 kimlik bilgilerine erişim Google API Konsolu'ndan yönetilir.

Cloud projesi en iyi uygulamaları için bu videoyu izleyin

Google OAuth doğrulaması

Google Ads API kapsamı için kimlik bilgilerini almak amacıyla kullanılan tüm Google Cloud uygulamalarının, kullanıcılarının doğrulanmamış kullanıcı arayüzü ekranı görmemesi için Google OAuth doğrulamasından geçmesi gerekir. 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 jeton onay süreci kapsamında gerçekleştirilen tüm incelemelere ek olarak yapılır. Google Ads API kapsamı hassas bir kapsam olduğundan gereklidir.

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

İşle ilgili herhangi bir kesinti yaşanmaması 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. Proje oluştur'u tıklayın, bir ad girin ve Oluştur'u tıklayın.

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

Google Ads API kullanımı için ücret alınmaz ancak toplam Cloud projesi sayısı için bir kota uygulanı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ı izleyin:

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

2. Google Ads API listede görünmüyorsa, bulmak için arama işlevini 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ü ve Yayınlama durumunu belirtmeniz gerekir. Aşağıdaki tabloda bu ayarların her bir kombinasyonunun bazı önemli özellikleri ve sınırlamaları vurgulanmaktadır. Daha ayrıntılı bilgi için Google Cloud Platform belgelerini inceleyin.

Kullanıcı türü	Yayınlanma durumu	Sınırlamalar
Dahili	Test	Yalnızca bir Google Cloud kuruluşuyla ilişkili projeler için kullanılabilir. OAuth izin ekranında listelenen en fazla 100 test kullanıcısı vardır. Test kullanıcıları, projeyle ilişkili Google Cloud Kuruluşunda dahili kullanıcılar olmalıdır. Yetkilendirmelerin süresi, izin alındıktan sonra 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ı vardır. Test kullanıcıları, Google Hesabı olan herhangi bir kullanıcı olabilir. Yetkilendirmelerin süresi, izin alındıktan sonra yedi gün içinde dolar.
Dahili	Üretimde	Yalnızca bir Google Cloud kuruluşuyla ilişkili projeler için kullanılabilir. Projeyle ilişkili olan Google Cloud Kuruluşu içinde yer alan tüm kullanıcıların yetkilendirilmesine olanak tanır.
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ı tamamlanmazsa projenizin Kullanıcı türü veya Yayınlama durumu ne olursa olsun aşağıdaki sonuçlar ortaya çıkar:

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

• Yalnızca 100 kullanıcıya yetki verebilirsiniz.

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

4. Sonraki sayfada PUAN EKLE VEYA KALDIRMA'yı tıklayın.

   • Sayfayı aşağı kaydırın ve Manuel olarak kapsam ekle altındaki 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ı düşünmüyorsanız test için kullanacağınız her kullanıcı hesabının e-posta adresini ekleyin, 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 geri dönüp UYGULAMA YAYINLA'yı tıklayarak Test olan Yayınlanma durumunu Ü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. Derlemek istediğiniz uygulama için en uygun türü belirlemek üzere aşağıdaki tabloya bakın:

Bu uygulama türünü seç	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 hemen başlamak istiyorsanız. Uygulamanız, Google kullanıcılarının kimliklerini yalnızca bir makineden doğrular.
Web uygulaması	Google Ads hesap verilerine erişmesi için uygulamanıza izin verebilecek bir kullanıcı olarak kimlik doğrulaması yapmak istiyorsunuz. Örneğin, üçüncü taraf hesapları yönetmek için birden fazla yetkilendirme kimlik bilgisini kolayca oluşturmak istiyorsanız. Uygulamanız, geri çağırma URL'leri gerektiriyor. Masaüstü uygulama akışında geri çağırma URL'leri desteklenmez.

Önemli Bilgi: Sunucu üzerinde çalışacak bir uygulama geliştirirken bile masaüstü uygulama akışını seçebilirsiniz. Aradaki fark, OAuth yetkilendirmesinin yerel olarak veya uzaktan tamamlanmasıdır. Masaüstü akışı, yetkilendirmenin yerel makinede tamamlanması için gerekirken web akışı, Google'ın yetkilendirme sunucusunda yetkilendirmenin tamamlanmasına olanak tanır.

Daha fazla bilgi için masaüstü uygulamaları veya web uygulamaları için Google Identity Platform OAuth dokümanlarına bakın.

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

Uygulamanızın türünü 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. Önceden oluşturulmuş bir projeyi 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. Daha önce bu proje için OAuth izin ekranı yapılandırmadıysanız bu işlemi şimdi yapmaya yönlendirilirsiniz. İ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. İşlem tamamlandığında 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 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. 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 testler 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'nize 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 loopback 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ğından İstemci Kimliğiniz ve İstemci Gizli Anahtarınız öğelerini panonuza kopyalayın. Bu ayrıntıları almak için daha sonra kimlik bilgileri sayfasına da dönebilirsiniz.