İlk istemci uygulamanızı kodlamaya başlamadan önce, henüz yapmadıysanız yapmanız gereken birkaç şey vardır.
İstemciniz için proje oluşturma
İstek gönderebilmeniz için öncelikle Google'a istemciniz hakkında bilgi vermeniz ve API'ye erişimi etkinleştirmeniz gerekir. Bunu, Google API Konsolu'nu kullanarak proje (ayarlar ve API erişim bilgilerinin adlandırılmış bir koleksiyonu) oluşturur ve uygulamanızı kaydedersiniz.
Android Over The Air API'yi kullanmaya başlamak için önce kurulum aracını kullanmanız gerekir. Bu araç, Google API Konsolu'nda proje oluşturma, API'yi etkinleştirme ve kimlik bilgileri oluşturma konusunda size rehberlik eder.
Projeyi izin verilenler listesine ekleme
Android Over The Air API'si yalnızca beyaz listeye eklenen projelerde kullanılabilir. Projeniz izin verilenler listesine eklenmemişse projeyi kullanmaya çalışırken 404 hata alırsınız.
İzin verilenler listesine eklenmek için Google Teknik Hesap Yöneticinize yeni proje kimliğinizi beyaz listeye eklemesi yönünde bir e-posta gönderin.
Proje kimliğini Cloud Kontrol Panelinizde bulabilirsiniz. Daha fazla bilgi için bu yardım dokümanını inceleyin.
İdeal olarak proje kimliğinin {company}-gota-api-{number} biçiminde olması gerektiğini unutmayın.
Beyaz listeye eklendikten sonra projeniz için Android Over The Air API'yi enable ve bu API'ye erişimle ilgili ayrıntılar için yetkilendirme nasıl yapıldığını inceleyin.
Yalnızca sağladığınız proje kimliğinin Android Over The Air API'sini kullanabileceğini belirtmek isteriz. API kullanımı için herhangi bir kişisel hesap kullanmak yerine bir hizmet hesabı (yetkilendirmede açıklandığı gibi) oluşturmanızı önemle tavsiye ederiz.
Android Over The Air Kontrol Paneli'ni deneyin
Bu API dokümanlarında, Android Over The Air Hesap Özeti'ni kullandığınız ve web programlama kavramları ile web veri biçimleri hakkında bilgi sahibi olduğunuz varsayılmaktadır.
Android Over The Air Kontrol Paneli'ni kullanmadıysanız koda başlamadan önce kullanıcı arayüzünü deneyin.
REST ile ilgili temel bilgileri öğrenin
API'yi çağırmanın iki yolu vardır:
- HTTP istekleri gönderme ve yanıtları ayrıştırma.
- İstemci kitaplıklarını kullanma.
İstemci kitaplıklarını kullanmamayı tercih ederseniz REST ile ilgili temel bilgileri öğrenmeniz 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, POST, GET, PUT veya DELETE gibi bir HTTP fiili kullanarak işlem belirtir. Bir kaynağı, aşağıdaki biçimde genel 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ı belgelerindeki yöntem tanımlarını faydalı bulabilirsiniz. Bu tanımlar, GET, POST, PUT ve DELETE özelliklerini içerir.
Android Over The Air API'de REST
Android Over The Air API işlemleri, doğrudan REST HTTP fiilleriyle eşlenir.
Android Over The Air API URI'ları için belirli biçimler şunlardır:
https://www.googleapis.com/android/over-the-air/v1/resourcePath?parameters
API'de desteklenen her işlem için kullanılan URI'ların tamamı Android Over The Air API Referansı belgesinde özetlenmiştir.
JSON ile ilgili temel bilgileri öğrenin
Android Over The Air API, verileri JSON biçiminde döndürür.
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.