Authentication

Tüm Google Ad Manager API çağrıları, OAuth2 kullanıcıların üçüncü taraf uygulamalarına izin vermesine olanak tanıdığından Uygulama, kullanıcı adına web hizmetleriyle etkileşime geçebilir. OAuth2, Kullanıcının Ad Manager hesabına erişmek için Ad Manager API istemci uygulamanız kullanıcı adını veya şifresini işlemek zorunda kalmadan.

OAuth2 kimlik bilgileri oluşturma

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

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

En uygun kimlik doğrulama türünün hangisi olduğunu görmek için aşağıdaki tabloya bakın. Ad Manager API uygulamanız için:

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ı

Kullanıcılara izin veren herhangi bir kullanıcı olarak kimlik doğrulaması yapmak istiyorsanız Ad Manager verilerine erişmesi için uygulamanıza izin vermeniz gerekir.

Daha fazla bilgi edinin.

2. OAuth2 kimlik bilgileri oluşturma

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

Hizmet Hesabı
  1. Google API Konsolu Kimlik Bilgileri sayfası.
  2. Proje açılır menüsünden Create a new project'i (Yeni proje oluştur) seçin, ardından bir ad girin ve isteğe bağlı olarak sağlanan proje kimliğini düzenleyin. Sonraki slayta geçin Oluştur.
  3. Kimlik bilgileri sayfasında Kimlik bilgileri oluştur'u seçin ve ardından Hizmet hesabı anahtarı'nı seçin.
  4. Yeni hizmet hesabı'nı ve JSON'yi seçin.
  5. Özel anahtar içeren bir dosyayı indirmek için Oluştur'u tıklayın.
ziyaret edin.
'nı inceleyin.
Web uygulaması
  1. Google API Konsolu Kimlik Bilgileri sayfası.
  2. Proje açılır menüsünden Create a new project'i (Yeni proje oluştur) seçin, ardından bir ad girin (isteğe bağlı olarak sağlanan proje kimliğini düzenleyin) ve Oluştur.
  3. Kimlik bilgileri sayfasında Kimlik bilgileri oluştur'u seçin ve ardından OAuth istemci kimliği'ni seçin.
  4. Sayfada bir ürün adı ayarlamanız istenebilir. İzin Ekranı sayfası; Bu durumda İzin ekranını yapılandır'ı tıklayın, istenen bilgileri girin ve şuraya dönmek için Kaydet'i tıklayın: Kimlik bilgileri sayfası.
  5. Uygulama Türü olarak Web Uygulaması'nı seçin. Şunu izleyin: JavaScript kaynaklarını girme, URI'ları yönlendirme veya her ikisini birden yapmaya ilişkin talimatlar.
  6. Oluştur'u tıklayın.
  7. Görüntülenen sayfada istemci kimliğini ve istemci gizli anahtarını kopyalayın. istemcinizi yapılandırırken bunlara ihtiyacınız olacak. Bu nedenle, panonuza kitaplığını açar.
İ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üşterinizden bunu yapmasını sağlamanız 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-posta adresini kullanarak formu doldurun. İlgili içeriği oluşturmak için kullanılan hizmet hesabı kullanıcısına Böylece, mevcut hizmet hesabı kullanıcısı kullanıcı arayüzü.
  6. Kaydet düğmesini tıklayın. Onaylayan bir mesaj gösterilir. hizmet hesabınızın eklenmesi.
  7. Kullanıcılar sekmesine gidip ardından mevcut hizmet hesabı kullanıcılarını görüntüleyin Hizmet Hesabı filtresini tıklayın.
ziyaret edin.
'nı inceleyin.
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 kendinizyapabilirsiniz.

Kamera arkası

İstemci kitaplıklarımız aşağıda belirtilen ayrıntıları otomatik olarak gerçekleştirir; böylece yalnızca kamera arkasında olanlarla ilgileniyorsanız okumaya devam edin. Bu bölüm, zaten aşina olan ileri düzey kullanıcılara yöneliktir. OAuth2 spesifikasyonu ve OAuth2'nin Google API'leriyle nasıl kullanılacağını öğrenin.

HTTP istek başlığı

Ad Manager API'sine yapılan her istekte HTTP başlığı bir erişim içermelidir eklemeniz gerekir:

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 çeşitli düzeylerde erişim sağlayabilir. CEVAP scope adlı değişken parametresi, kaynakların ve işlemleri gerçekleştirmelerini sağlar. Erişim jetonu isteği sırasında uygulaması scope parametresinde bir veya daha fazla değer gönderir.

Ad Manager'da aşağıda gösterilen tek bir kapsam bulunur. Yetkilendirme işlemi, kullanıcı düzeyinde analiz etmenizi sağlar.

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