Authentication

Tüm Google Ad Manager API çağrıları, kullanıcıların üçüncü taraf uygulamalarına 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şimde bulunabilir. OAuth2, Ad Manager API istemci uygulamanızın, kullanıcının kullanıcı adını veya şifresini işlemesi ya da depolaması gerekmeden kullanıcının Ad Manager hesabına erişmesini sağlar.

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ün hangisi olduğunu görmek için aşağıdaki tabloya göz atın:

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 listesinden Yeni proje oluştur'u seçin, proje için bir ad girin ve isterseniz sağlanan proje kimliğini düzenleyin. Oluştur'u tıklayın.
3. Kimlik Bilgileri sayfasında Kimlik bilgisi oluştur'u, ardından Hizmet hesabı anahtarı'nı seçin.
4. Yeni hizmet hesabı'nı ve JSON'ı seçin.
5. Özel anahtar içeren bir dosyayı 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 listesinden 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. Kullanıcı rızası ekranı sayfasında ürün adı belirlemeniz istenebilir. Bu durumda Kullanıcı rızası ekranını yapılandır'ı tıklayın, istenen bilgileri girin ve Kimlik bilgileri sayfasına dönmek için Kaydet'i tıklayın.
5. Application Type (Uygulama Türü) için Web Application'ı (Web Uygulaması) seçin. JavaScript başlangıç noktalarını, yönlendirme URI'lerini veya her ikisini de girmek için talimatları uygulayın.
6. Oluştur'u tıklayın.
7. Görünen sayfada istemci kimliğini ve istemci gizli anahtarını panonuza kopyalayın. İstemci kitaplığınızı yapılandırırken bu bilgilere ihtiyacınız olacaktır.

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

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

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 Google API'leriyle OAuth2'yi 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 yapılan her isteğin HTTP üst bilgisi, ş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ı bir değişken parametre, erişim jetonunun izin verdiği kaynak ve işlemler 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 yalnızca bir kapsamı vardır ve bu kapsam aşağıda gösterilmiştir. Yetkilendirme, ürün içinde kullanıcı düzeyinde yapılmalıdır.