Cihaz oluşturma ve yönetme

Bu kılavuzda, cihazların nasıl oluşturulacağı, yönetileceği ve silineceği ele alınmaktadır. Doğru cihaz yönetimi, sorunsuz bir kullanıcı deneyimi 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ıyla bir cihaz oluşturduğunda Ambient API, Google tarafından oluşturulan bir id içeren bir AmbientDevice nesnesi döndürür. Bu id'yi 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, kullanıcı kimlik doğrulamasıyla aynı anda cihaz oluşturabilen basitleştirilmiş bir OAuth akışı sunar. İlk OAuth isteğinizde ek state parametresini ileterek cihaz oluşturma sürecini doğrudan kullanıcının oturum açma akışına bağlayabilirsiniz. Böylece, taraması gereken QR kodlarının sayısını azaltarak kullanıcı deneyimini basitleştirebilirsiniz.

Daha fazla ayrıntı ve örnek için Ambient API için basitleştirilmiş kimlik doğrulama akışı başlıklı kılavuzu inceleyin.

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ı verir.

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ı Getirme

Belirli bir cihazla ilgili bilgileri 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 belirli özelliklerini (ör. görünen adı) güncelleyebilirsiniz. Bu sayede kullanıcılar cihazlarını kişiselleştirebilir ve Google Fotoğraflar'da cihazları daha kolay tanıyabilir.

Cihazları Silin

Doğru 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ı kesme: Bir kullanıcı, uygulamanızın Google Fotoğraflar hesabından bağlantısını keserse ilgili cihazı silmeniz gerekir.
  • Bağlantısı kesilen cihazlar: Bir id'nin izini kaybederseniz ancak oluşturma sırasında kullanılan requestId'a sahipseniz devices.delete ile bağlantısı kesilen cihazı kaldırmak için requestId'ı kullanabilirsiniz. Bu, yanlışlıkla kopya oluşturulmasını önler ve kullanıcının hesabını temiz tutar.

Önemli noktalar ve en iyi uygulamalar

  • Cihaz yaşam döngüsü ve kullanıcı yetkilendirmesi: Cihazların ve kullanıcı yetkilendirme jetonlarının yaşam döngüsünü yönetmeniz gerekir. Cihazların ne kadar süre boyunca etkin kalacağını ve bir cihaz devre dışı kaldığında veya jetonunun süresi dolduğunda jeton yenileme veya yeniden yetkilendirme işlemlerini nasıl yapacağınızı düşünün.
  • Hata İşleme: Cihazla ilgili tüm API çağrıları için güçlü bir hata işleme yöntemi uygulayın. Aşağıdaki gibi senaryolara hazırlıklı olun:
    • NOT_FOUND: Cihaz yoksa veya kullanıcıya ait değilse.
    • RESOURCE_EXHAUSTED: Cihaz sınırını aşarsanız.
    • ALREADY_EXISTS: Zaten mevcut olan bir requestId ile cihaz oluşturmaya çalışıyorsanız

Sonraki Adımlar