Cihaz oluşturma ve yönetme

Bu rehberde cihazların nasıl oluşturulacağı, yönetileceği ve silineceği açıklanmaktadır. Doğru cihaz yönetimi, sorunsuz bir kullanıcı deneyimi oluşturmaya ve Ambient API'nin verimli bir şekilde kullanılmasına yardımcı olur.

Cihazlar Oluşturma

Kullanıcı, TV ve Sınırlı Giriş Cihazı Uygulamaları için OAuth 2.0 akışını kullanarak kimliğini başarıyla doğruladıktan sonra Google Fotoğraflar hesabında bir cihaz oluşturun.

Uygulamanız devices.create yöntemini kullanarak başarılı bir şekilde cihaz oluşturduğunda Ambient API, Google tarafından oluşturulan id içeren bir AmbientDevice nesnesi döndürür. Bu id cihazını güvenli bir şekilde saklayın ve kullanıcılarınızla ilişkilendirin.

OAuth ile Kolaylaştırılmış Cihaz Oluşturma

Ambient API, kolaylaştırılmış bir OAuth akışı sunar. İlk OAuth isteğinizde ek state parametresini ileterek ve eşleşen requestId ile devices.create yöntemini çağırarak cihaz oluşturma işlemini doğrudan kullanıcının oturum açma akışına bağlayabilirsiniz. Böylece, kullanıcının taraması gereken QR kodu sayısını azaltarak kullanıcı deneyimini basitleştirebilirsiniz.

Daha fazla bilgi ve örnek için Ambient API için kolaylaştırılmış kimlik doğrulama akışı kılavuzuna bakın.

Cihaz sınırları

Uygulamanız kullanıcı başına en fazla 100 cihaz oluşturabilir. Bu sınır aşılırsa API, RESOURCE_EXHAUSTED hatası döndürür.

Cihazları Yönetme

Bir cihaz oluşturulup kullanıcının Google Fotoğraflar hesabına bağlandıktan sonra cihazın yaşam döngüsünü yönetmeniz gerekebilir.

Cihazları alma

Belirli bir cihazla ilgili bilgi almak için benzersiz id ile devices.get yöntemini kullanın. Bu, cihazın durumunu (ör. mediaSourcesSet değerinin doğru olup olmadığını) kontrol etmek için kullanışlıdır.

Cihazları Güncelleme

devices.patch yöntemini kullanarak mevcut bir cihazın görünen adı gibi belirli özelliklerini güncelleyebilirsiniz. Bu sayede kullanıcılar cihazlarını kişiselleştirebilir ve Google Fotoğraflar'da daha kolay tanımlayabilir.

Cihazları Silin

Düzgün bir temizlik ve kullanıcı kontrolü için cihazları silme stratejisi uygulayın. devices.delete yöntemini kullanarak cihazları silebilirsiniz.

Cihazları silmeyle ilgili aşağıdaki senaryoları göz önünde bulundurun:

  • Kullanıcı bağlantısının kesilmesi: Bir kullanıcı, uygulamanızın Google Fotoğraflar hesabıyla bağlantısını keserse ilgili cihazı silmeniz gerekir.
  • Sahipsiz cihazlar: Bir id cihazın izini kaybederseniz ancak oluşturma sırasında kullanılan requestId hâlâ sizdeyse sahipsiz cihazı kaldırmak için requestId ile devices.delete kullanabilirsiniz. Bu sayede, yanlışlıkla yinelenen öğeler eklenmesi önlenir ve kullanıcının hesabı düzenli kalır.

Dikkat Edilmesi Gereken Önemli Noktalar ve En İyi Uygulamalar

  • Cihaz yaşam döngüsü ve kullanıcı yetkilendirmesi: Cihazların yaşam döngüsünü ve kullanıcı yetkilendirme jetonlarını yönetmeniz gerekir. Cihazların ne kadar süreyle etkin kalacağını ve bir cihaz etkinliğini kaybederse veya jetonu süresi dolarsa jeton yenileme ya da yeniden yetkilendirme işlemlerini nasıl yapacağınızı göz önünde bulundurun.
  • Hata Yönetimi: Cihazla ilgili tüm API çağrıları için hataların etkili bir şekilde yönetilmesini sağlayın. Aşağıdaki gibi senaryolara hazırlıklı olun:
    • NOT_FOUND: Cihaz yoksa veya kullanıcının değilse.
    • RESOURCE_EXHAUSTED: Cihaz sınırını aşarsanız.
    • ALREADY_EXISTS: Halihazırda mevcut olan bir requestId ile cihaz oluşturmaya çalışıyorsanız.

Sonraki Adımlar