Method: sessions.create
Gera uma nova sessão em que o usuário pode escolher fotos e vídeos para acesso de terceiros.
Se o usuário não tiver uma conta ativa do Google Fotos, um erro FAILED_PRECONDITION
será retornado.
Se o aplicativo cliente criar muitas sessões por usuário, um erro RESOURCE_EXHAUSTED
será retornado. É improvável que os clientes atinjam esses limites em circunstâncias normais. No entanto, recomendamos que os clientes liguem para sessions.delete
após cada sessão para não ultrapassar os limites de recursos de forma proativa.
Solicitação HTTP
POST https://photospicker.googleapis.com/v1/sessions
O URL usa a sintaxe de transcodificação gRPC.
Corpo da solicitação
O corpo da solicitação contém uma instância de PickingSession
.
Corpo da resposta
Se a solicitação for bem-sucedida, o corpo da resposta incluirá uma instância de PickingSession
.
Escopos de autorização
Requer o seguinte escopo OAuth:
https://www.googleapis.com/auth/photospicker.mediaitems.readonly
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2024-11-06 UTC.
[null,null,["Última atualização 2024-11-06 UTC."],[[["This endpoint creates a session for users to select photos and videos for third-party access."],["A `FAILED_PRECONDITION` error occurs if the user lacks an active Google Photos account."],["Excessive session creation leads to a `RESOURCE_EXHAUSTED` error, though unlikely under normal use."],["Clients should call `sessions.delete` after each session to avoid exceeding resource limits."],["Requires the `https://www.googleapis.com/auth/photospicker.mediaitems.readonly` OAuth scope for authorization."]]],["This describes the creation of a new session for users to grant third-party access to their photos and videos. It uses a `POST` request to `https://photospicker.googleapis.com/v1/sessions`. The request body contains a `PickingSession` instance, and a successful response returns a new `PickingSession`. Requires `photospicker.mediaitems.readonly` OAuth scope. Errors include `FAILED_PRECONDITION` for inactive accounts and `RESOURCE_EXHAUSTED` for excessive session creation. Deleting sessions with `sessions.delete` is recommended to manage resources.\n"]]