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 OAuth 2.0'ı nasıl ayarlayacağınız açıklanmaktadır. Bu adımların yalnızca bir kez yapılması gerekir. OAuth 2.0 kimlik bilgileriniz için izin verilen kapsamları iptal etmeniz, silmeniz veya değiştirmeniz gerekmediği sürece bu adımları tekrar uygulamanız gerekmez.

OAuth 2.0 kimlik bilgileri oluşturma

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

  2. Önce istemcinin OAuth istemcisini indir simgesini, ardından sonraki ekranda JSON'ı İNDİR düğmesini tıklayarak istemcinin JSON dosyasını indirin.

    Dosyayı ana dizininize kaydedin. Böylece artık yerel dosyanız ~/client_secret_XXX.apps.googleusercontent.com.json (burada XXX, projenize özel değerler olacaktır) olur. Kod örneğini çalıştırmak için bu dosyayı bir sonraki adımda kullanacağız.

İstemci kitaplığını ayarlama

  1. Terminalde GenerateUserCredentials kod örneğini çalıştırın. İndirdiğiniz OAuth 2.0 JSON dosyasını iletmek için komut satırı işaretlerini kullanın.

    Gradle'ı kullanarak komut satırından kod örneğini çalıştırmak için aşağıdaki komutu kullanabilirsiniz:
    ./gradlew --console=plain --quiet runExample \
          --example="authentication.GenerateUserCredentials \
          --oAuthClientFile ${HOME}/client_secret_XXX.apps.googleusercontent.com.json"
        
  2. Bu kod örneği, bir URL'yi ziyaret etmenizi ister. Bu URL'de, uygulamanın sizin adınıza Google Ads hesabınıza erişmesine izin vermeniz gerekir.

    Paste this URL in your browser:
    https://accounts.google.com/o/oauth2/auth?access_type=offline&client_id=****...
        

    URL'ye gizli bir tarayıcı oturumunda veya gizli pencerede gidin. Google Ads'e erişmek için kullandığınız Google Hesabı ile oturum açın. Genellikle bu, hesap hiyerarşisinde yönetmeniz gereken tüm hesapları içeren bir Google Ads yönetici hesabına giriş için kullanılan e-posta adresidir. OAuth 2.0 izin ekranında Devam'ı tıklayın.

    OAuth 2.0 izin ekranı

    Yetkilendirmenin başarılı olduğunu belirten bir mesajın yer aldığı sayfaya yönlendirilirsiniz.

    Authorization code was successfully retrieved.
    
    Check the console output from `GenerateUserCredentials` for further instructions.
        
  3. Kod örneğini çalıştırdığınız konsola dönün. Kod örneğinin tamamlandığını ve yenileme jetonunuzun yanı sıra bazı talimatların gösterildiğini görürsünüz. Ardından, istemci kitaplığını yapılandırmak için uygulamanız gereken talimatlar gösterilir:

        #Mon Apr 18 09:07:51 EDT 2022
        api.googleads.refreshToken=1/Yw.........................................
        api.googleads.clientId=...........-...............apps.googleusercontent.com
        api.googleads.developerToken=INSERT_DEVELOPER_TOKEN_HERE
        api.googleads.clientSecret=........................
        
  4. Tarih yorumundan # çıkışın sonuna kadar olan satırları ads.properties dosyanıza kopyalayın.

    INSERT_DEVELOPER_TOKEN_HERE yerine geliştirici jetonunuzu yazın.

    En kolay kurulum için ads.properties dosyasını ana dizininize yerleştirin.