İlk Uygulamanız: Ön Koşullar

İlk istemci uygulamanızı kodlamaya başlamadan önce, henüz yapmadıysanız yapmanız gereken birkaç şey vardır.

Google Hesabı oluşturma ve Search Ads 360 izinlerini alma

Search Ads 360 API'yi kullanmak için bir Google Hesabı'na ve Search Ads 360'tan bu hesaba verilen uygun izinlere ihtiyacınız vardır:

1. Google Hesabınız yoksa hesap oluşturun.

2. Google Hesabınız için Search Ads 360 kullanıcısı oluşturmasını bir Search Ads 360 ajans yöneticisinden isteyin.

   Raporları indirmek için birlikte çalışacağınız reklamverenler için görüntüleme iznine sahip olmanız gerekir.

   Dönüşüm eklemek veya düzenlemek için birlikte çalışacağınız reklamverenler için düzenleme iznine sahip olmanız gerekir. Paylaşılan Floodlight yapılandırmasında, dönüşümleri yüklemek istediğiniz her alt reklamveren için düzenleme izninizin olması gerekir. Üst reklamverene veya dönüşümleri yüklemeyeceğiniz alt reklamverenlere erişiminizin olması gerekmez. Dönüşümleri ziyaretlerle ilişkilendirmek için tıklama kimlikleri kullanıyorsanız tıklama kimliğini oluşturan reklamverene yönelik düzenleme erişiminiz olduğundan emin olun. Düzenleme erişiminizin olmadığı bir reklamverene ait tıklama kimliği belirtirseniz istek başarılı olmaz.

   Ajans yöneticisi, hesabınızı belirli reklamverenlere erişimi olan bir reklamveren kullanıcısı olarak ayarlayabilir veya hesabınızı ajanstaki tüm reklamverenlere erişimi olan ajans kullanıcısı gibi daha yüksek bir erişim düzeyiyle ayarlayabilir.

API Dönüşüm Hizmeti'ni etkinleştirme

Dönüşümlerle ilgili veriler yüklemek istiyorsanız Ajans Yöneticisi ayrıcalıklarına sahip bir Search Ads 360 kullanıcısının Search Ads 360 kullanıcı arayüzünde oturum açması ve API dönüşüm hizmetini etkinleştirmesi gerekir. Talimatlar için Search Ads 360 yardım merkezine bakın.

İstemciniz için bir Google API Konsolu projesi ve OAuth kimlik bilgileri oluşturun

1. Google API Konsolu kurulum aracını başlatın.
   Kurulum aracı; proje oluşturma (veya mevcut bir projeyi kullanma), Search Ads 360 API'yi etkinleştirme ve OAuth 2.0 kimlik bilgileri oluşturma konusunda size yol gösterir.
2. Uygulamanızı kaydedin sayfasında mevcut bir projeyi seçin veya Proje oluştur'u seçin. Ardından Devam et'i tıklayın.
3. Google API Konsolu Search Ads 360 API'yi etkinleştirdikten sonra, Kimlik bilgilerine git düğmesini tıklayın.
4. Kimlik bilgileri oluştur sayfasında aşağıdaki bilgileri girin:
   • Hangi API'yi kullanıyorsunuz?: Search Ads 360 API'si
   • Hangi verilere erişeceksiniz?: Kullanıcı verileri
5. İleri düğmesini tıklayın.

   Kurulum aracı artık OAuth 2.0 istemci kimliği oluşturmanıza yardımcı oluyor.

6. Kurulum aracındaki diğer adımları uygulayın.

sa360Api.py dosyasını yükleme

Search Ads 360, yetkilendirme ayarlama sürecini kolaylaştırmak için bir yardımcı program komut dosyası sağlar. Tam bir uygulama tasarlayıp yazmadan önce veri gönderip almayı denemek isterseniz bu komut dosyasını JSON biçiminde veri göndermek ve almak için de kullanabilirsiniz. Bu doküman sitesindeki JSON örneklerinin çoğunu kopyalayıp doğrudan komut dosyasına girebilirsiniz.

Komut dosyasını yüklemek için:

1. Python 2.7'yi yükleyin.
   Komut dosyası, Python 3.x ile çalışmaz.
2. cURL'yi yükleyin.
3. sa360Api.zip dosyasını indirin.
4. sa360Api.zip klasöründen sa360Api.py öğesini ayıklayın.
5. sa360Api.py dosyasını yürütülebilir hale getirin.

REST ile ilgili temel bilgileri öğrenin

API'yi çağırmanın iki yolu vardır:

• İstemci kitaplıklarını kullanma.
• HTTP istekleri gönderme ve yanıtları ayrıştırma.

Müşteri kitaplıklarını kullanmamaya karar verirseniz REST'in temellerini bilmeniz gerekir.

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ı dokümanlarında yer alan yöntem tanımlarını faydalı bulabilirsiniz. Bu dokümanlar GET, POST, PUT ve DELETE ile ilgili spesifikasyonları içerir.

Search Ads 360 API'de REST

Search Ads 360 API işlemleri doğrudan REST HTTP fiilleriyle eşlenir.

Search Ads 360 API URI'leri için özel biçim:

https://www.googleapis.com/doubleclicksearch/v2/resourcePath?parameters

API'deki her desteklenen işlem için kullanılan URI'lerin tamamı API Referansı'nda özetlenmiştir.

JSON ile ilgili temel bilgileri öğrenin

REST kullanıyorsanız istek gövdeleri için JSON biçimini kullanmanız gerekir. Yanıtların JSON veya CSV biçiminde olmasını belirtebilirsiniz.

JSON (JavaScript Nesne Gösterimi), rastgele veri yapılarının basit bir metin temsilini sağlayan, yaygın ve dile bağlı olmayan bir veri biçimidir. Daha fazla bilgi için json.org adresini ziyaret edin.