İ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ınızın ve Search Ads 360'tan bu hesaba verilen uygun izinlerinizin olması gerekir:
Google Hesabınız yoksa bir hesap oluşturun.
Bir Search Ads 360 Ajans Yöneticisi'nden Google Hesabınız için bir Search Ads 360 kullanıcısı oluşturmasını isteyin.
Raporları indirmek için, çalışacağınız reklamverenler için görüntüleme izniniz olması gerekir.
Dönüşüm eklemek veya düzenlemek için birlikte çalışacağınız reklamverenler için düzenleme iznine ihtiyacınız olacaktır. 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üklemediğ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 düzenleme erişiminizin bulunduğundan emin olun. Düzenleme erişiminiz olmayan bir reklamverenin tıklama kimliğini belirtirseniz istek başarılı olmaz.
Ajans Yöneticisi, hesabınızı belirli reklamverenlere erişimi olan bir Reklamveren kullanıcı olarak veya 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 verileri 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 göz atın.
İstemciniz için Google API Konsolu projesi ve OAuth kimlik bilgileri oluşturun
- 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 bilgilerini oluşturma konusunda size yol gösterir. - Uygulamanızı kaydedin sayfasında mevcut bir projeyi veya Proje oluştur'u seçin. Ardından Devam et'i tıklayın.
- Google API Konsolu, Search Ads 360 API'yi etkinleştirdikten sonra Kimlik bilgilerine git düğmesini tıklayın.
- Kimlik bilgisi 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
- İleri düğmesini tıklayın.
Kurulum aracı artık OAuth 2.0 istemci kimliği oluşturmanıza yardımcı olmayı teklif etmektedir.
- Kurulum aracındaki diğer adımları uygulayın.
sa360Api.py'yi yükleyin
Search Ads 360, yetkilendirmeyi oluşturma 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 istiyorsanız bu komut dosyasını JSON biçiminde veri gönderip almak için de kullanabilirsiniz. Bu belge sitesindeki JSON örneklerinin çoğunu kopyalayabilir ve bunları doğrudan komut dosyasına girebilirsiniz.
Komut dosyasını yüklemek için:
- Python'u yükleyin 2.7.
Komut dosyası, Python 3.x ile çalışmıyor. - cURL'yi yükleyin.
- sa360Api.zip dosyasını indirin.
sa360Api.zipöğesindensa360Api.pyçıkarın.sa360Api.pydosyasını yürütülebilir duruma 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.
İstemci kitaplıklarını kullanmamaya karar verirseniz REST ile ilgili temel bilgileri anlamanız 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 fiilini kullanarak POST, GET, PUT veya DELETE gibi bir işlem belirtir. Bir kaynağı aşağıdaki biçimdeki global olarak benzersiz bir URI ile 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ındaki yöntem tanımlarını yararlı bulabilirsiniz. Bu tanımlar, GET, POST, PUT ve DELETE özelliklerini içerir.
Search Ads 360 API'sinde REST
Search Ads 360 API işlemleri, doğrudan REST HTTP fiilleriyle eşlenir.
Search Ads 360 API URI'ları için belirli bir biçim şöyledir:
https://www.googleapis.com/doubleclicksearch/v2/resourcePath?parameters
API'de desteklenen her işlem için kullanılan URI'ların tam grubu 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 olduğunu belirtebilirsiniz.
JSON (JavaScript Object Notation [JavaScript Nesne Gösterimi]), rastgele veri yapılarının basit metin gösterimini sağlayan yaygın bir dilden bağımsız veri biçimidir. Daha fazla bilgi için json.org adresine bakın.