Method: devices.create

Kullanıcının Google Fotoğraflar hesabında bir ambiyans cihazı oluşturur.

Sağlanan requestId değerine sahip bir cihaz zaten varsa ALREADY_EXISTS hatası döndürülür. Yinelenen cihazları önlemek için aşağıdakileri yapın:

  • Mevcut cihazın deviceId bilgisini biliyorsanız devices.get\'i arayarak bu bilgiyi alın.
  • deviceId değerini bilmiyorsanız bu yöntemi yeniden denemeden önce requestId ile devices.delete'ı arayarak ebeveyni olmayan cihazı kaldırın.

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

HTTP isteği

POST https://photosambient.googleapis.com/v1/devices

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Sorgu parametreleri

Parametreler
requestId

string

İsteğe bağlı. Bu istek için istemci tarafından sağlanan benzersiz tanımlayıcı. Bu, ağ hatası durumunda kaynak yinelemesini azaltmak için kullanılır.

Bu kimlik, UUID (4. sürüm) dizesi biçiminde olmalı ve aşağıdaki koşulları karşılamalıdır:

  • Kullanıcıyla ilgili hassas tanımlayıcı bilgiler içermemelidir.
  • "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" (veya 8-4-4-4-12) biçiminde, kısa çizgilerle ayrılmış beş gruba bölünmüş 32 on altılı karakter içermelidir.

İstek içeriği

İstek metni, AmbientDevice öğesinin bir örneğini içerir.

Yanıt gövdesi

Başarılı olursa yanıt metni, yeni oluşturulmuş bir AmbientDevice örneği içerir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/photosambient.mediaitems