Kimlik doğrulama

Tüm Google Ad Manager API çağrıları, kullanıcıların üçüncü taraf uygulamalara izin vermesine olanak tanıyan açık bir standart olan OAuth2 aracılığıyla yetkilendirilmelidir. Böylece, uygulama kullanıcı adına web hizmetleriyle etkileşim kurabilir. OAuth2, Ad Manager API istemci uygulamanızın, kullanıcının kullanıcı adını veya şifresini işlemek veya depolamak zorunda kalmadan kullanıcının Ad Manager hesabına erişebilmesini sağlar.

OAuth2 kimlik bilgilerini oluştur

OAuth2 kimlik bilgilerini oluşturmak için aşağıdaki adımları uygulayın.

1. Kimlik doğrulama türünüzü belirleme

Ad Manager API uygulamanız için hangi kimlik doğrulama türünün en uygun olduğunu görmek üzere aşağıdaki tabloyu kontrol edin:

OAuth2 kimlik doğrulama türünüzü seçin
Hizmet hesabı

Yalnızca kendi Ad Manager verilerinize erişmeniz gerekiyorsa bunu seçin.

Daha fazla bilgi edinin.
Web uygulaması

Uygulamanızın Ad Manager verilerine erişmesine izin veren herhangi bir kullanıcı olarak kimlik doğrulaması yapmak istiyorsanız bunu seçin.

Daha fazla bilgi edinin.

2. OAuth2 kimlik bilgileri oluştur

Kimlik doğrulama türünüzü belirledikten sonra, aşağıdaki ilgili sekmeyi tıklayın ve OAuth2 kimlik bilgilerini oluşturmak için talimatları uygulayın:

Hizmet Hesabı
  1. Google API Konsolu Kimlik Bilgileri sayfasını açın.
  2. Proje açılır menüsünden Yeni proje oluştur'u seçin, proje için bir ad girin ve isteğe bağlı olarak, sağlanan proje kimliğini düzenleyin. Oluştur'u tıklayın.
  3. Kimlik bilgileri sayfasında Kimlik bilgisi oluştur'u ve ardından Hizmet hesabı anahtarı'nı seçin.
  4. Yeni hizmet hesabı'nı, ardından JSON'yi seçin.
  5. Özel anahtar içeren bir dosya indirmek için Oluştur'u tıklayın.
Web uygulaması
  1. Google API Konsolu Kimlik Bilgileri sayfasını açın.
  2. Proje açılır menüsünden Yeni proje oluştur'u seçin, proje için bir ad girin (ve isteğe bağlı olarak sağlanan Proje kimliğini düzenleyin) ve Oluştur'u tıklayın.
  3. Kimlik Bilgileri sayfasında, Kimlik bilgileri oluştur'u ve ardından OAuth istemci kimliği'ni seçin.
  4. İzin Ekranı sayfasında bir ürün adı ayarlamanız istenebilir. İstenirse İzin ekranını yapılandır'ı tıklayın, istenen bilgileri sağlayın ve Kimlik Bilgileri sayfasına dönmek için Kaydet'i tıklayın.
  5. Uygulama Türü olarak Web Uygulaması'nı seçin. JavaScript kaynaklarını girmek, URI'ları yönlendirmek veya her ikisini birden yapmak için talimatları uygulayın.
  6. Oluştur'u tıklayın.
  7. İstemci kitaplığınızı yapılandırırken bunlara ihtiyacınız olacağından, görüntülenen sayfada istemci kimliğini ve istemci gizli anahtarını panonuza kopyalayın.
İstemci kimliği ve istemci gizli anahtarı ekran görüntüsü

3. Ad Manager ağınızı yapılandırma

Üçüncü taraf geliştiriciyseniz müşterinizin bu adımı sizin için yapmasını istemeniz gerekebilir.

Hizmet Hesabı
  1. Ad Manager ağınıza gidin.
  2. Yönetici sekmesini tıklayın.
  3. API erişiminin etkinleştirildiğinden emin olun.
  4. Hizmet hesabı kullanıcısı ekle düğmesini tıklayın.
  5. Hizmet hesabı e-postasını kullanarak formu doldurun. Hizmet hesabı kullanıcısına, bu hizmet hesabı kullanıcısı kullanıcı arayüzündeki varlıklara erişecekmiş gibi varlıklara erişim izinleri verilmelidir.
  6. Kaydet düğmesini tıklayın. Hizmet hesabınızın eklendiğini onaylayan bir mesaj görünür.
  7. Kullanıcılar sekmesine gidip Hizmet Hesabı filtresini tıklayarak mevcut hizmet hesabı kullanıcılarını görüntüleyin.
Web uygulaması
  1. Ad Manager ağınıza gidin.
  2. Yönetici sekmesini tıklayın.
  3. API erişiminin etkinleştirildiğinden emin olun.

4. İstemci kitaplığı yapılandırma ve kullanma

İstemci kitaplığınızdaki kimlik bilgilerini kullanmak için aşağıdaki ilgili kılavuzu izleyin:

İstemci kitaplıklarımızdan birini kullanmamayı seçerseniz OAuth2 hizmet hesabı veya web uygulaması akışını kendiniz uygulamanız gerekir.

Sahne arkası videoları

İstemci kitaplıklarımız aşağıda ele alınan ayrıntıları otomatik olarak halleder. Bu yüzden, perde arkasında neler olduğunu öğrenmek istiyorsanız okumaya devam edin. Bu bölüm, OAuth2 spesifikasyonuna aşina olan ve OAuth2'nin Google API'leriyle nasıl kullanılacağını bilen ileri düzey kullanıcılara yöneliktir.

HTTP istek başlığı

Ad Manager API'sine yapılan her istekteki HTTP başlığı, şu biçimde bir erişim jetonu içermelidir:

Authorization: Bearer ACCESS_TOKEN

Örneğin:

POST … HTTP/1.1
Host: …
Authorization: Bearer 1/fFAGRNJru1FTz70BzhT3Zg
Content-Type: text/xml;charset=UTF-8
Content-Length: …

<?xml version="1.0"?>
<soap:Envelope xmlns:soap="http://www.w3.org/2001/12/soap-envelope">
…
</soap:Envelope>

Kapsam

Tek bir erişim jetonu, birden fazla API'ye farklı derecelerde erişim izni verebilir. scope adlı değişken parametresi, erişim jetonunun izin verdiği kaynak ve işlemleri kontrol eder. Erişim jetonu isteği sırasında uygulamanız scope parametresinde bir veya daha fazla değer gönderir.

Ad Manager'ın yalnızca bir kapsamı vardır ve aşağıda gösterilmiştir. Yetkilendirme işlemi ürün içinde kullanıcı düzeyinde yapılmalıdır.

Kapsam İzinler
https://www.googleapis.com/auth/dfp Ad Manager'daki kampanyalarınızı görüntüleyin ve yönetin.