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

Bu kılavuzda, kendi kimlik bilgilerinizi ve masaüstü akışını ya da 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 istiyorsanız GenerateUserCredentials örneğini kullanın.

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

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

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

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

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

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

  1. Bir terminalde, OAuth2 istemci kimliğinizi ve gizli anahtarınızı girmenizin istendiği 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ğini ve sırrını girmeniz istenir. 1. adımdaki ayrıntıları sağlayın.

  3. Örnekte, tarayıcıda otomatik olarak bir URL açılır. 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, sizin adınıza Google Ads hesabınıza erişmesi için yetkilendirmenizin istendiği bir URL'ye yönlendirir.

    İzin ekranı

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

    Yenileme jetonunuz getirildi. Diğer talimatlar için konsol çıkışını kontrol edin.

  5. Örneği çalıştırdığınız konsola dönün. Örnek tamamlanmış olmalı ve yenileme jetonunuz ile bazı talimatları görüntüleyecektir ve ardından istemci kitaplığını yapılandırmak için ihtiyaç duyacağınız özellikler bulunmalıdır:

    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

Önceden API çağrıları yapacağınız Google Ads hesabını 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 sayfasına göz atın.