Auth'u ayarlama

DV360 satıcı API'si ilk katılımı

DV360 Satıcı API'si için API'yi kullanmaya başlamak üzere birkaç önemli adım vardır. DV360 Satıcı API'si, izin verilenler listesi tabanlı Google Cloud API olarak kullanıma sunulur ve kimlik doğrulama için OAuth'u kullanır.

İzin verilenler listesi süreci, DV360 Satıcı API Ekibi ile iletişime geçilerek gerçekleştirilir.

İlk katılım adımları:

  1. https://console.cloud.google.com/ adresine giderek bir Google Hesabı oluşturun.
    • Bu hesap, üretim istemciniz için erişim jetonlarını yönetmek üzere kullanılır. Kişisel Gmail hesabınızı kullanmayın.
    • Hesap bir Google grubu olamaz.
    • Mevcut bir Google Cloud projesi kullanıyorsanız: Hesap, projenin yöneticisi olmalıdır.
  2. Hesabın izin verilenler listesine eklenmesi için kaydolduğunuz hesap bilgilerini kullanarak Google DV360 ile iletişime geçin.
  3. Hesabınızın izin verilenler listesine eklenmesini bekleyin.
  4. İsteğe bağlı ve engellemeyen: Kapsama alanına(doubleclickbidmanager) erişmek için uygulamanız için bir OAuth doğrulama incelemesi isteği gönderin.
  5. https://console.cloud.google.com/ adresine gidin. API'ler ve Hizmetler -> Kitaplık -> Özel'e gidin. DV360 Satıcı API'sini, kullanabileceğiniz API'lerden biri olarak listeleyebilirsiniz.
  6. DV360 Seller API'yi etkinleştirme
  7. Kimlik Bilgileri -> Kimlik Bilgisi Oluştur -> Hizmet Hesabı Anahtarı'na gidin. Buradaki talimatları uygulayın: https://developers.google.com/identity/protocols/OAuth2ServiceAccount

    Hizmet hesabı oluşturma:

    Not: Mevcut bir hizmet hesabını (ör. DV360 Reporting API için) yeniden kullanmak isteyip istemediğinizi bize bildirin.

    Google Cloud API kimlik doğrulaması ve yetkilendirmesi (genellikle "auth" olarak gruplandırılır) genellikle bir hizmet hesabı kullanılarak yapılır. Hizmet hesabı, kodunuzun uygulama kimlik bilgilerini doğrudan Cloud API'ye göndermesine olanak tanır. Kullanıcı hesabı gibi hizmet hesapları da bir e-posta adresiyle temsil edilir. Ancak kullanıcı hesabından farklı olarak hizmet hesabı yalnızca bir uygulamaya aittir ve yalnızca oluşturulduğu API'ye erişmek için kullanılabilir. Örnek olarak, Google Cloud Platform Console'u kullanarak hizmet hesabı kimlik bilgilerinin nasıl oluşturulacağını göstereceğiz.

    Google Cloud Console'u kullanma

    Google Cloud Console API Yöneticisi→Kimlik bilgileri sayfasında "Kimlik bilgileri oluştur→Hizmet hesabı anahtarı"nı seçin.

    alt_text

    Ardından, "Hizmet hesabı" açılır menüsünden "Yeni hizmet hesabı"nı seçin.

    alt_text

    Bu hizmet hesabı için bir "Ad" yazın. Bu ad, "Hizmet hesabı kimliğiniz" için varsayılan ad olarak kullanılır (oluşturulan hizmet hesabı kimliği adresinde "@" işaretinin solunda). İsterseniz bu hizmet hesabı kimliği adını değiştirebilirsiniz. Bu adlar istediğiniz gibi olabilir. Önemli olan bunları hatırlamanızdır. "Anahtar türü" bölümünde bu değeri "JSON" olarak bırakmanızı öneririz. "Oluştur"u tıkladığınızda GCP Console bir JSON anahtarı (.json metin dosyası olarak) oluşturur, dosyayı bilgisayarınıza indirmenizi ister ve Hizmet hesabı oluşturuldu iletişim kutusunu görüntüler.

    alt_text

    Oluşturulan JSON anahtarı aşağıdaki örnek JSON anahtarına benzer: 

    {
  "type": "service_account",
  "project_id": "project-id",
  "private_key_id": "some_number",
  "private_key": "-----BEGIN PRIVATE KEY-----\n....
  =\n-----END PRIVATE KEY-----\n",
  "client_email": "<api-name>api@project-id.iam.gserviceaccount.com",
  "client_id": "...",
  "auth_uri": "https://accounts.google.com/o/oauth2/auth",
  "token_uri": "https://accounts.google.com/o/oauth2/token",
  "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
  "client_x509_cert_url": "https://www.googleapis.com/...<api-name>api%40project-id.iam.gserviceaccount.com"
}

    Özel anahtarınızı içerdiği (ve bu anahtarın tek kopyası olduğu) için bu JSON dosyasını güvenli bir şekilde saklayın. Google Cloud Platform API'sine kimlik bilgileri göndermek istediğinizde kodunuzda bu hizmet hesabı anahtar dosyasını referans olarak kullanmanız gerekir.

  8. Oluşturduğunuz hizmet hesabı bilgilerini kullanarak DV360 ile iletişime geçin. Özellikle bu hizmet hesabının e-postasına ihtiyacımız var. Bu, yetkilendirme için başka bir izin verilenler listesi işlemidir.
  9. Hizmet hesabınız API'yi çağırmaya yetkilendirildikten sonra API dokümanları için https://developers.google.com/display-video/seller adresine bakabilirsiniz. Yetkilendirme jetonunu manuel olarak almak için https://github.com/google/oauth2l adresindeki talimatları inceleyin. (Hizmet hesabı anahtarınızın JSON sürümünü indirmiş olmanız gerekir.) Oauth jetonunun programatik olarak nasıl alınacağına dair ayrıntılı talimatlar için https://cloud.google.com/docs/authentication/production adresini ziyaret edin.

Önemli: OAuth kapsamının "doubleclickbidmanager" olması gerekir

Önceki
Genel bakış
Sonraki
İstemci kitaplığı