OAuth Masaüstü ve Web Uygulaması Akışları

Bu kılavuzda, kendi kimlik bilgilerinizi ve masaüstü akışını veya web akışını kullanarak API erişimi için OAuth2'yi nasıl ayarlayacağınız adım adım açıklanmıştır.

Tek bir hesap için OAuth2 kimlik bilgileri oluşturma

Google Ads API hesaplarına çağrı yapmanın en kolay yolu

1. API çağrısı yapmak istediğiniz tüm hesapları tek bir Google Ads yönetici hesabı altında bağlayın.

2. Yönetici hesabına erişimi olan bir kullanıcı için OAuth2 kimlik bilgileri oluşturmak üzere GenerateUserCredentials örneğini kullanın.

3. Google Ads API'yi kullanarak yönetmeniz gereken tüm hesaplara çağrı yapmak için OAuth2 kimlik bilgilerini kullanın.

OAuth2 kimlik bilgileriniz için izin verilen kapsamları iptal etmediğiniz, silmediğiniz veya değiştirmeniz gerekmediği sürece bu adımların yalnızca bir kez uygulanması gerekir.

1. Adım - OAuth2 kimlik bilgilerini oluşturun

1. Google Ads API için bir Google API Konsolu projesini yapılandırma adımlarını uygulayın.

2. İstemci kimliği ve gizli bilgilerini not edin, ardından bu sayfaya geri dönün.

2. Adım - İstemci kitaplığını oluşturma

1. Bir terminalde, OAuth2 istemci kimliğinizi ve gizli anahtarınızı girmenizi isteyen GenerateUserCredentials örneğini çalıştırın.

   Bu, giriş yapmanızı gerektiren etkileşimli bir örnektir.

   dotnet run GenerateUserCredentials.csproj
   

2. Örnekte, OAuth2 istemci kimliği ve gizli bilgilerini sağlamanız istenir. 1. adımdaki ayrıntıları sağlayın.

3. Örnek, tarayıcıda otomatik olarak bir URL açar. Tarayıcı oturumunuzda oturum açmadıysanız, web sayfası Google Hesabınızda oturum açmanızı ister. Zaten oturum açtıysanız, oturum açma istemini atlar ve sizi bir URL'ye yönlendirir. Burada, uygulamayı sizin adınıza Google Ads hesabınıza erişmesi için yetkilendirmeniz istenir.

   Not: Google Ads'e erişmek için kullandığınız Google Hesabı ile oturum açın. Bu genellikle, hesap hiyerarşisinde yönetmeniz gereken tüm hesapları içeren bir Google Ads yönetici hesabına gönderilen giriş e-postasıdır.

   

4. Ardından, yetkilendirmenin başarılı olduğunu belirten bir mesajın bulunduğu bir sayfaya yönlendirilirsiniz.

   Yenileme jetonunuz getirildi. Daha fazla talimat için konsol çıkışını kontrol edin.

5. Örneği çalıştırdığınız konsola geri dönün. Örnek, tamamlanmış olmalı ve yenileme jetonunuzu ve bazı talimatları gösterip ardından istemci kitaplığını yapılandırmak için ihtiyaç duyacağınız özellikleri göstermelidir:

   Copy the following content into your App.config file.
   
   <add key = 'OAuth2Mode' value = 'APPLICATION' />
   <add key = 'OAuth2ClientId' value = '******' />
   <add key = 'OAuth2ClientSecret' value = '******' />
   <add key = 'OAuth2RefreshToken' value = '******' />
   
   Make sure you also set the LOGIN_CUSTOMER_ID header. See
   https://developers.google.com/google-ads/api/docs/client-libs/dotnet/configuration#google_ads_api_settings
   to learn more.
   
   <add key = 'LoginCustomerId' value = 'INSERT_LOGIN_CUSTOMER_ID_HERE' />
   
   See https://developers.google.com/google-ads/api/docs/client-libs/dotnet/configuration
   for alternate configuration options.
   

Etkileşimli uygulamalar için OAuth2 kimlik bilgileri oluşturma

Google Ads hesabını önceden API çağrıları yapmak için bilmiyorsanız, oturum için oturum açmış kullanıcının kimlik bilgilerini kullanarak çalışma zamanında bu hesabı bulabilirsiniz. Oturum açmış olan kullanıcının kimliğinin doğrulandığı ve OAuth2 kimlik bilgilerinin çalışma zamanında alındığı bir örnek için AuthenticateInAspNetCoreApplication bölümüne bakın.