DV360 Exchange Reporting API'ye ilk katılım ve OAuth kurulumu

DV360 Exchange Reporting API, üçüncü taraf borsa (3PE) iş ortaklarına Display & Video 360'taki performans raporlarına programatik erişim sağlar.

DV360 Exchange Reporting API, izin verilenler listesine dayalı ve OAuth kullanan bir Google Cloud API'si olarak sunulur. İzin verilenler listesi süreci, DV360 Exchange Reporting API ekibi tarafından yürütülür.

Prosedür

DV360 Exchange Reporting API'ye ilk katılım adımları şunlardır:

  1. Google Cloud Console'da Google Hesabı'na kaydolun.

    Bu hesabın, üretim istemcinizin erişim jetonlarını yönetmek için kullanılacağını unutmayın. Bu nedenle, kişisel Gmail hesabınızı kullanmayın.

  2. İzin verilenler listesine eklenmesi için hesap bilgileriyle Google DV360 ile iletişime geçin.

  3. İzin verilenler listesine alındığınıza dair bildirim aldıktan sonra, uygulamanızın doubleclickbidmanager kapsamına erişebilmesi için OAuth doğrulama incelemesi isteğinde bulunun.

  4. Google Cloud Console'da oturum açın.

    API'ler ve Hizmetler > Kitaplık > Özel'e gidin. Kullanabileceğiniz API'lerden biri olarak bir DV360 Exchange Reporting API'si görmeniz gerekir. DV360 Exchange Reporting API'yi etkinleştirin.

  5. Kimlik bilgileri > Kimlik bilgisi oluştur > Hizmet hesabı anahtarı'na gidin. Hizmet hesabı oluşturma talimatlarını uygulayın.

Hizmet hesabı

Hizmet hesabı, kodunuzun uygulama kimlik bilgilerini doğrudan API'ye göndermesine olanak tanır. Hizmet hesabı, kullanıcı hesabı gibi bir e-posta adresiyle temsil edilir. Ancak hizmet hesabı, kullanıcı hesabından farklı olarak yalnızca bir uygulamaya aittir ve yalnızca oluşturulduğu API'ye erişmek için kullanılabilir.

Google Cloud Console'u kullanarak hizmet hesabı kimlik bilgileri oluşturma adımları şunlardır:

  1. API Yöneticisi > Kimlik Bilgileri sayfasında, Kimlik bilgisi oluştur → Hizmet hesabı anahtarı'nı seçin.

  2. Hizmet hesabı açılır listesinden Yeni hizmet hesabı'nı seçin.

    Bu hizmet hesabı için bir Ad girin. Bu ad, oluşturulan hizmet hesabı kimliği adresinde @ simgesinin solunda hizmet hesabı kimliğinizin varsayılan adı olarak kullanılır.

    Anahtar türü bölümünde bu değeri JSON olarak bırakmanızı öneririz. .json metin dosyası olarak JSON anahtarı oluşturmak için Oluştur'u tıklayın. İstendiğinde dosyayı bilgisayarınıza indirin. Hizmet hesabı oluşturuldu iletişim kutusu gösterilir.

    Aşağıda örnek bir JSON anahtarı verilmiştir:

    {
  "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"
}

  3. Özel anahtarınızı içerdiğinden ve bu dosya, anahtarın tek kopyası olduğundan JSON dosyanızı güvenli bir şekilde saklayın. Kodunuz API'ye çağrı yaptığında bu dosyadaki kimlik bilgileri gerekir.

  4. Oluşturduğunuz hizmet hesabı bilgileriyle, özellikle hizmet hesabının e-posta adresiyle DV360 ile iletişime geçin. Bu, API erişimi için izin verilenler listesi sürecinin bir parçasıdır.

Erişim jetonu

Hizmet hesabınızın API'ye çağrı yapma yetkisi verildikten sonra API kılavuzlarındaki örneklerle devam edebilirsiniz. Erişim jetonunu manuel olarak almak için oauth2l gibi bir araç kullanabilir veya programatik olarak kimlik doğrulamak için istemci kitaplıklarımızdan birini kullanabilirsiniz.