Arka plan

Başlamadan önce

  1. Hesap temsilcinizden hesaplar için uygun izinleri ayarlamasını isteyin uygulamanızın erişeceği durumlar.
  2. Authorized Buyers kavramlarına aşina değilseniz Authorized Buyers Yardım Merkezi ve kullanıcı arayüzü ile deneme yapın. Uygulamanızın gerçek zamanlı teklif vermesi bekleniyorsa GZT Protokolü belgeleri.
  3. Şurayı ziyaret edin: API Konsolu yeni bir proje oluşturmaktır. Geliştirici Google Hesabınızda oturum açın veya hesap oluşturun. Daha sonra sizden proje oluşturmanız ve onay vermeniz istenir Hizmet Şartları'na uymayı kabul etmiş olursunuz.

Üst ve alt hesaplar

Üst ve alt öğe içeren bir hesap yapısında çalışıyorsanız nasıl etkilediğini anlarsanız daha verimli çalışabilirsiniz, etkileşimde bulunur. Aşağıda kısa bir özet verilmiştir:

Alt hesaplar

Bir alt hesaba erişim izni veren kimlik bilgilerine sahip bir kullanıcı yalnızca Hesaplarıyla ilişkili kaynakları görüntüleyebilir ve değiştirebilir. Alt hesaplar diğer alt veya üst hesaplara ait kaynakları görüntüleme ya da değiştirme.

Üst hesaplar

Üst hesaba erişim izni veren kimlik bilgilerine sahip kullanıcı bu bilgileri görüntüleyebilir ve ilişkilendirilmiş tüm hesapların yanı sıra üst hesap için kaynakları değiştirme alt hesaplar. Bu kullanıcı, belirli bir kaynağın tümünü listeleyen işlemler için hesap ve tüm kullanıcılara ait verileri içeren bir yanıt alır. alt hesaplar. Alt lisanslara yönelik kaynakları hedefleyen diğer istek türlerinde üst hesabın, alt öğe için accountId yol parametresi belirtmesi gerekir hesaplarında (accountId) oturum açmaz.

REST API veri modeli

Kaynak, benzersiz bir tanımlayıcıya sahip bağımsız bir veri varlığıdır. İlgili içeriği oluşturmak için kullanılan Hesap kaynağı, Authorized Buyers hesap girişini temsil eder ve kök kaynaktır veri sınıfını kullanmanız gerekir. API'nin yöntemleri bağımsız Hesap kaynakları ve Hesaplar kaynak koleksiyonları.

Hesaplar Kaynak şunları içerir: hesap kimliği, çerez eşleştirmede kullanılan bilgiler, teklif veren konumları, teklif isteklerinin gönderildiği URL ve istek değerini girin.

Hesaplar kaynağı ve koleksiyonuna ek olarak, Ad Exchange Alıcı API'si de şu veri yapılarını tanımlar:

Teklif veren konumu

Teklif veren konumları, Hesap Kaynakları ile döndürülen yapılardır Ad Exchange'in teklif isteklerini göndermesi gereken URL'yi ve Ad exchange'in göndermesi gereken saniye başına maksimum sorgu sayısı Burada teklif veren konumu (JSON olarak ifade edilir) örneği: 

"bidderLocation": [
    {
      "url": "http://bid.url.com/bidder",
      "maximumQps": 1500
    }
  ],

Öğe sayısı

Öğeler, hesapların listesini sağlar. JSON biçiminde ifade edilen öğelere ilişkin bir örneği burada bulabilirsiniz: 

{
  "kind": "adexchangebuyer#accountsList",
  "items": [
    accounts Resource
  ]
}

Desteklenen işlemler

Ad Exchange Alıcı API'sini etkinleştirin. Tüm işlemler için şunlar gerekir: onaylama.

İşlem Açıklama REST HTTP eşlemeleri
list Kimliği doğrulanmış olan kullanıcının erişebildiği tüm hesapları listeler belirtir. Koleksiyon URI'sında GET.
al Belirli bir Hesaplar kaynağını alır. Kaynak URI'daki GET.
güncelle Belirli bir Hesaplar kaynağını günceller. Bir kaynak URI'sında PUT. Burada güncellenmiş kaynak.

Görüşme stili

REST, veri isteme ve değiştirmeye kullanışlı ve tutarlı yaklaşım sağlayan bir yazılım mimarisi stilidir.

REST terimi, "Representational State Transfer"in (Temsili Durum Aktarımı) kısaltmasıdır. Google API'leri bağlamında, Google tarafından saklanan verilerin temsillerini almak ve değiştirmek için HTTP fiillerini kullanma anlamına gelir.

RESTful bir sistemde, kaynaklar bir veri deposunda saklanır. Bir istemci, sunucunun belirli bir işlemi (ör. kaynak oluşturma, alma, güncelleme veya silme) gerçekleştirmesi için istek gönderir. Sunucu, işlemi gerçekleştirir ve yanıt gönderir. Bu yanıt genelde belirtilen kaynağın bir temsili biçimindedir.

Google'ın RESTful API'lerinde istemci, HTTP fiili kullanarak (ör. POST, GET, PUT veya DELETE) bir işlem belirtir. Aşağıdaki biçimde yer alan küresel olarak benzersiz bir URI ile kaynak belirtir:

https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters

Tüm API kaynaklarının HTTP tarafından erişilebilen benzersiz URI'ları olduğu için REST, veri önbelleğe almayı etkinleştirir ve web'deki dağıtılan altyapıyla birlikte çalışmak üzere optimize edilmiştir.

HTTP 1.1 standartları belgelerindeki yöntem tanımlarını yararlı bulabilirsiniz; GET, POST, PUT ve DELETE özelliklerini içeriyor.

Ad Exchange Alıcı API'sinde REST

Desteklenen işlemler, aşağıda açıklandığı gibi doğrudan REST HTTP fiilleriyle eşlenir. API işlemleri.

API URI'lerinin spesifik biçimi şunlardır:

https://www.googleapis.com/adexchangebuyer/v1.4/resourceID?parameters

burada resourceID, Hesap kaynağı ve parameters herhangi bir sorguya uygulanacak parametreleri içerir. Görüntüleyin standart sorgu parametreleri ve referans belgeleri inceleyebilirsiniz.

resourceID yol uzantısının biçimi şu anda üzerinde çalıştığınız kaynağı belirlemenize olanak tanır. Örneğin:

https://www.googleapis.com/adexchangebuyer/v1.4/accounts
https://www.googleapis.com/adexchangebuyer/v1.4/accounts/id

API'de desteklenen her işlem için kullanılan URI'ların tamamı özetlendiği liste referans belgeleri.

Aşağıda, bunun Ad Exchange Alıcı API'sinde nasıl işlediğine dair bir örnek verilmiştir.

Kimliği doğrulanmış kullanıcının hesap listesini al:

GET https://www.googleapis.com/adexchangebuyer/v1.4/accounts

Veri biçimi

JSON

JSON (JavaScript Object Notation - JavaScript Nesne Gösterimi), rastgele veri yapılarının basit metin temsilini sağlayan yaygın, dilden bağımsız bir veri biçimidir. Daha fazla bilgi için json.org adresine bakın.