Method: sessions.create

Génère une nouvelle session au cours de laquelle l'utilisateur peut sélectionner des photos et des vidéos pour un accès tiers.

Si l'utilisateur ne dispose pas d'un compte Google Photos actif, une erreur FAILED_PRECONDITION est renvoyée.

Si l'application cliente crée trop de sessions par utilisateur, une erreur RESOURCE_EXHAUSTED est renvoyée. En temps normal, les clients ne devraient pas atteindre ces limites. Toutefois, nous recommandons toujours aux clients d'appeler sessions.delete après chaque session afin de respecter de manière proactive les limites de ressources.

Une fois qu'un utilisateur appuie sur le bouton OK pour terminer une session de picking, pickerUri ne fonctionne plus. Créez une session pour permettre à l'utilisateur de sélectionner d'autres photos.

Requête HTTP

POST https://photospicker.googleapis.com/v1/sessions

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.

Cet ID permet de simplifier l'expérience de sélection pour les applications qui utilisent le flux OAuth 2.0 pour les appareils à saisie limitée.

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 divisés 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 PickingSession.

Corps de la réponse

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

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/photospicker.mediaitems.readonly