Auth'u ayarlama

Display & Video 360 Seller API'ye İlk Katılım

Display & Video 360 Seller API'ye geçişle ilgili birkaç temel adım vardır. DV360 Seller API, izin verilenler listesine dayalı bir Google Cloud API'sidir ve kimlik doğrulama ile yetkilendirme için OAuth 2.0'ı kullanır.

İzin verilenler listesine ekleme süreci, Display & Video 360 Seller API Ekibi tarafından yürütülür.

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

  1. https://console.cloud.google.com/ adresini ziyaret ederek Google Hesabı'na kaydolun.
    • Bu hesap, üretim istemcinizin erişim jetonlarını yönetmek için kullanılır. Kişisel Gmail hesabı kullanmayın.
    • Hesap, Google Grubu olamaz.
    • Mevcut bir Google Cloud projesi kullanıyorsanız: Hesap, projenin yöneticisi olmalıdır.
  2. İzin verilenler listesine eklenmesi için hesap ayrıntılarınızla birlikte Google DV360 Ekibi ile iletişime geçin.
  3. Hesabınızın etkinleştirildiğine dair onayı bekleyin.
  4. İsteğe bağlı ve engelleyici olmayan: https://www.googleapis.com/auth/doubleclickbidmanager kapsamına erişmek için uygulamanızla ilgili OAuth doğrulama incelemesi isteği gönderin.
  5. Google Cloud Console'da API'ler ve Hizmetler > Kitaplık > Özel'e gidin. Projenizde DV360 Seller API'nin kullanılabildiğini görmelisiniz.
  6. DV360 Seller API'yi etkinleştirin.
  7. API'ler ve Hizmetler > Kimlik Bilgileri > Kimlik Bilgileri Oluştur > Hizmet Hesabı Anahtarı'na gidin. OAuth 2.0 Hizmet Hesabı belgelerindeki kurulum talimatlarını uygulayın.

    Hizmet hesabı oluşturma:

    Not: DV360 Reporting API için kullanılanlar gibi mevcut bir hizmet hesabını yeniden kullanmak istiyorsanız lütfen bize bildirin.

    Google Cloud API kimlik doğrulaması ve yetkilendirmesi (genellikle "kimlik doğrulama" 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. Hizmet hesabı, kullanıcı hesabı gibi bir e-posta adresiyle temsil edilir. Ancak kullanıcı hesabının aksine, 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 bilgisi oluştur→Hizmet hesabı anahtarı" seçeneğini belirleyin.

    alt_text

    Ardından, "Hizmet hesabı" açılır listesinden "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). Ancak isterseniz bu hizmet hesabı kimliği adını değiştirebilirsiniz. Bu adlar rastgele 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österir.

    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ğinden (ve bu dosya, anahtarın tek kopyası olduğundan) bu JSON dosyasını güvenli bir şekilde saklayın. Google Cloud Platform API'ye kimlik bilgileri göndermek istediğinizde kodunuzda bu hizmet hesabı anahtar dosyasına başvurmanız gerekir.

  8. Oluşturduğunuz hizmet hesabı bilgileriyle (özellikle hizmet hesabı e-posta adresi) DV360 ekibiyle iletişime geçin. Bu, yetkilendirme için ikinci bir izin verilenler listesi adımıdır.
  9. Hizmet hesabınızın API'yi çağırması için yetki verildikten sonra DV360 Seller API belgelerine başvurabilirsiniz. Kimlik doğrulama jetonunu manuel olarak almak için oauth2l araç deposundaki talimatlara bakın (indirdiğiniz JSON hizmet hesabı anahtarını kullanarak). OAuth jetonlarını programatik olarak edinmeyle ilgili ayrıntılı talimatlar Google Cloud kimlik doğrulama belgelerinde yer almaktadır.

Önemli: OAuth kapsamı https://www.googleapis.com/auth/doubleclickbidmanager olmalıdır.

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