Method: devices.create

Crée un appareil ambiant dans le compte Google Photos de l'utilisateur.

Si un appareil avec le requestId fourni existe déjà, une erreur ALREADY_EXISTS est renvoyée. Pour éviter les doublons, procédez comme suit:

  • Si vous connaissez le deviceId de l'appareil existant, appelez devices.get pour le récupérer.
  • Si vous ne connaissez pas le deviceId, appelez devices.delete avec le requestId pour supprimer l'appareil orphelin avant de réessayer cette méthode.

Vous pouvez créer jusqu'à 100 appareils par utilisateur de votre application. Si cette limite est dépassée, une erreur RESOURCE_EXHAUSTED est renvoyée.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de requête

Paramètres
requestId

string

Facultatif. Identifiant unique fourni par le client pour cette requête. Cela permet de limiter la duplication de ressources en cas de défaillance du réseau.

Cet ID doit avoir le format d'une chaîne UUID (version 4) et respecter les exigences suivantes:

  • Ne doit pas contenir d'informations d'identification sensibles sur l'utilisateur.
  • Doit contenir 32 caractères hexadécimaux répartis en cinq groupes séparés par des tirets, au format "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" (ou 8-4-4-4-12).

Corps de la requête

Le corps de la requête contient une instance de AmbientDevice.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une nouvelle instance de AmbientDevice.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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