Authentication

Tüm Google Ad Manager API çağrıları, kullanıcıların üçüncü taraf uygulamalarına izin vermesini sağlayan 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şlemesine ya da saklamasına gerek kalmadan kullanıcının Ad Manager Yönetici Hesabına erişmesine olanak tanır.

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

Ad Manager API uygulamanız için en uygun kimlik doğrulama türünü görmek üzere aşağıdaki tabloya bakın:

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

Yalnızca kendi Ad Manager verilerinize erişmeniz gerekiyorsa bu seçeneği belirleyin.

Daha fazla bilgi edinin.
Web uygulaması

Uygulamanıza Ad Manager verilerine erişme izni veren herhangi bir kullanıcı olarak kimlik doğrulaması yapmak istiyorsanız bu seçeneği belirleyin.

Daha fazla bilgi edinin.

2. OAuth2 kimlik bilgileri oluşturma

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 Create a new project'i (Yeni proje oluştur) 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 bilgileri oluştur'u ve ardından Hizmet hesabı anahtarı'nı seçin.
  4. Yeni hizmet hesabı'nı ve JSON'u 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 Create a new project'i (Yeni proje oluştur) seçin, proje için bir ad girin (ve isteğe bağlı olarak, sağlanan proje kimliğini düzenleyin) ve Create'i (Oluştur) tıklayın.
  3. Kimlik Bilgileri sayfasında Kimlik bilgileri oluştur'u ve ardından OAuth istemci kimliği'ni seçin.
  4. Kullanıcı rızası ekranı sayfasında bir ürün adı belirlemeniz istenebilir. Bu durumda Kullanıcı rızası ekranını yapılandır'ı tıklayın, istenen bilgileri girin ve Kaydet'i tıklayarak Kimlik Bilgileri sayfasına dönün.
  5. Application Type (Uygulama Türü) için Web Application'ı (Web Uygulaması) seçin. JavaScript kaynaklarını, yönlendirme URI'lerini veya her ikisini birden girmek için talimatları uygulayın.
  6. Oluştur'u tıklayın.
  7. Açılan sayfada, istemci kitaplığınızı yapılandırırken ihtiyacınız olacağı için 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ı gerekebilir.

Hizmet Hesabı
  1. Ad Manager ağınıza gidin.
  2. Yönetici sekmesini tıklayın.
  3. API erişimi'nin 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, varlıklara kullanıcı arayüzünden erişiyormuş gibi erişme izni verilmelidir.
  6. Save (Kaydet) düğmesini tıklayın. Hizmet hesabınızın eklendiğini onaylayan bir mesaj gösterilir.
  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şimi'nin etkinleştirildiğinden emin olun.

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

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

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

Kamera arkası

İstemci kitaplıklarımız aşağıda ele alınan ayrıntıları otomatik olarak halleder. Bu nedenle, yalnızca arka planda neler olduğunu merak ediyorsanız okumaya devam edin. Bu bölüm, OAuth2 spesifikasyonuna aşina olan ve OAuth2'yi Google API'leriyle nasıl kullanacağını bilen ileri düzey kullanıcılar için hazırlanmıştır.

HTTP istek başlığı

Ad Manager API'ye gönderilen her istekteki HTTP üstbilgisi, ş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ı düzeylerde erişim izni verebilir. scope adlı değişken parametre, erişim jetonunun izin verdiği kaynak ve işlem grubunu 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 aşağıda gösterilen tek bir kapsamı vardır. Yetkilendirme, ürün içinde kullanıcı düzeyinde yapılmalıdır.

Kapsam İzinler
https://www.googleapis.com/auth/admanager Ad Manager'da kampanyalarınızı görüntüleyip yönetebilirsiniz.